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About This Guide 


Utilities Reference gives you essential information about Novell® NetWare® 6.5 utilities. For more 
information about any utility, see the online help for that utility. Unless otherwise specified, the 
commands in this guide apply to NetWare 6.5 SP4 or later. 


For step-by-step instructions to accomplish specific tasks, or for information on NetWare concepts, 
follow the cross-reference links listed with the respective utilities. 


Some new utilities have been included with OES. Some legacy NetWare utilities have been 
discontinued, while others have been combined with related utilities. 


Before you can work effectively with OES utilities, you must have a basic understanding about the 
NDS® and Novell eDirectory™ infrastructures. For more information, see the Novell eDirectory 8.8 
Administration Guide. 


Audience 


This guide is intended for anyone using the utilities included with NetWare. 


Feedback 


We want to hear your comments and suggestions about this manual and other documentation 
included with this product. Please use the User Comments feature at the bottom of each page of the 
online documentation. 

Documentation Updates 

For the most recent version of Utilities Reference, see the online NetWare 6.5 SP8 Documentation 
Web site (http://www.novell.com/documentation/nw65). 


Documentation Conventions 


In Novell documentation, a greater-than symbol (>) is used to separate actions within a step and 
items in a cross-reference path. 


A trademark symbol (0, ™, etc.) denotes a Novell trademark. An asterisk (*) denotes a third-party 
trademark. 


When a single pathname can be written with a backslash for some platforms or a forward slash for 
other platforms, the pathname is presented with a backslash. Users of platforms that require a 
forward slash, such as Linux* or UNIX”, should use forward slashes as required by your software. 


Also, in this Utilities Reference, certain command syntax conventions are used. The following MAP 
example illustrates several of these conventions, and the subsequent table lists and explains all the 
possible conventions. 


MAP [P | NP] [option] drive:= [drive:|path] 


About This Guide 





TIP: Unless specifically noted otherwise in the documentation, text typed at command line prompts, 
in configuration files, etc., is not case sensitive and can be entered in either upper- or lowercase 





letters. 
Convention Explanation 
Boldface Boldface characters indicate items that you type at the prompt, such as commands. 
characters 
Italicized Italicized characters indicate variables that you replace with information pertinent to 
characters your task. 
Ellipses indicate that parameters, options, or settings can be repeated. 
[] An item enclosed in square brackets is optional. You can enter the command with or 
without the item. 
[11 Items enclosed by nested square brackets are optional. But if you use the items 
within the innermost brackets, you must also use the items within the outer brackets. 
| When items are separated by a delimiter bar, you can use either item, but not both. 
{} Braces indicate that you must choose at least one of the enclosed options. 
<> Angle brackets enclose a descriptive name for any value that is provided as output 


by a computer. 


User Comments 


We want to hear your comments and suggestions about this manual and the other documentation 
included with this product. Please use the User Comment feature at the bottom of each page of the 
online documentation, or go to www.novell.com/documentation/feedback.html and enter your 
comments there. 
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Utilities 


This chapter gives you essential information about Novell® utilities. For more information about 
each utility, see the online help for that utility. Unless otherwise specified, the commands apply to 
NetWare®. 


For step-by-step instructions to accomplish specific tasks, or for information on NetWare concepts, 
follow the cross-reference links listed with the respective utilities. 


1.1 ABORT REMIRROR 


Purpose 


Use at the server console to stop remirroring a logical partition. Abort Remirror can be used on any 
NetWare mirror, regardless of type as long as all the partition types in the mirror match. This 
includes NSS, TRAD, SBD, and iSCSI devices and any other NetWare partition types that are 
mirrored. 


Syntax 


ABORT REMIRROR logical partition number 





Parameter Use to 


logical_partition_number Specify the number of the logical partition you want to stop remirroring. 





NOTE: To view a list of disk partitions, execute the MIRROR STATUS command. See 
Section 1.92, “MIRROR STATUS,” on page 99. 


Example 
To stop remirroring logical partition 0x2, enter 


ABORT REMIRROR 2 





Additional Information 


Topic See 

Restart remirroring Section 1.133, “REMIRROR PARTITION,” on page 164 

Mirroring and unmirroring For NSS volumes on NetWare, see “Managing NSS Software RAID 
partitions Devices” in the NW 6.5 SP8: NSS File System Administration Guide . 


For Traditional volumes, see “Using Software RAID1 Devices for Data 
Fault Tolerance” in the NW6.5 SP8: Traditional File System 
Administration Guide. 
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1.2 Activatemodule 


Purpose 


Use at the System Console prompt to load or start modules that are preloaded by the startup.ncf 
file or modules that were loaded using the load -s command. 


Preloading modules is required to avoid a fatal loss of access to essential driver files during a time 
period in the boot process when access to the FAT (DOS) partition containing the files is not 
possible. This period begins when the first driver is activated and ends when the partition is made 
available through NetWare drivers instead of Real Mode (BIOS/DOS) drivers. 


If you have installed a new driver that works with the CIOS specification, you can use this command 
to install and test your load options on the driver before adding a command to load it to the 
startup .ncf file. 


Syntax 
activatemodule = all|module_name 
For example: 


activatemodule idecd.cdm 


Parameter Use to 
all Activate all modules that have been preloaded. 
module_name Specify the name of a preloaded module that you want to activate. 


Additional Information 


For related information, see Section 1.137, “Removemodule,” on page 167. 


1.3 ADD NAME SPACE 


Purpose 


Use at the server console to add support for storing files for other file systems on a NetWare volume. 





IMPORTANT: Before you can use this command, you must load a name space module. See 
Section 1.82, “LOAD,” on page 87. 





Syntax 





ADD NAME SPACE [name [TO [VOLUME]] volume_name] 














Parameter Use to 


(no parameter) Display the loaded name spaces. 
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Parameter Use to 


name Specify the name of the name space module you loaded. Supported 
names are 


LONG (OS/2*, Windows*) 
MAC (Macintosh*) 

NFS (NFS*) 

FTAM (FTAM) 


FTAM is an add-on module that you can purchase from another provider. 


volume_name Specify the name of the volume where you want to apply the 
namespace. 


Using ADD NAME SPACE 
+ You need to add a name space only once to a volume with the ADD NAME SPACE command. 


Each time you mount a volume to which you added a name space (for example, each time you 
bring up the server), the corresponding name space module is autoloaded. 





NOTE: Because you don't need to add a name space to a volume each time the server comes 
up, you don't need to put the ADD NAME SPACE command in the autoexec.ncf file. 





+ When name space support is added to a NetWare Traditional volume, another entry is created in 
the directory table for the directory and file naming conventions of that name space (file 
system). 


+ With name space support on NSS volumes, the name space entry is part of the directory or file 
metadata. 


Additional Information 


Topic See 


Adding name space support “Adding a Name Space” in the NW6.5 SP8: Traditional File System 
Administration Guide 


1.4 ALERT 


Purpose 


Use at the server console to manage NetWare® alerts. You can enable or disable the display and 
logging of specific alerts, limit the amount of information displayed with an alert, and control other 
aspects of alert messages. 
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Syntax 





ALERT nmID command On|Off 


Parameter 


nmID 


command 


On|Off 


Use to 


Specify the nmID number of the alert you want to manage. This number 
appears in parentheses whenever the alert is generated. 


For example, server address changes cause a 50019 alert. The alert 
message includes the alert ID number in brackets, like this: 
[nmID=50019]. 


Specify the functionality to be turned on or off for the alert. 
Valid command values are: 


EVENT 
LOG 
EVERYONE 
CONSOLE 
BELL 

ID 

LOCUS 
ALERT 
NMID 

ALL 


Enable or disable the functionality of the command parameter. 


Command Parameter Values 


Command 
EVENT 
LOG 
EVERYONE 
CONSOLE 
BELL 


ALERT 
NMID 
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Function 

Generates an event when the alert is generated. 
Sends the alert message to a log file. 

Sends the alert to everyone on the network. 
Displays the alert message on the server console. 
Sounds a warning bell when the alert is generated. 


Displays ID information. This information appears in some older error 
and alert messages but is no longer used. 


Displays locus information. This information appears in some older error 
and alert messages but is no longer used. 


Generates the alert. 


Displays the alert nmID in the alert message. 


Command Function 


ALL Enables or disables the LOG, CONSOLE, EVERYONE, and BELL 
commands at the same time. 


Using ALERT 


+ Use ALERT to stop the logging of less important alerts or to prevent the repeated display of 
alerts you don't want to see on the server console. 


+ You can specify one command parameter at a time. Repeat the ALERT command to execute 
additional command parameters. (The exception is the ALL command, which lets you set the 
LOG, CONSOLE, EVERYONE and BELL commands at the same time.) 


Examples 


¢ The following command turns off logging, console display, and the warning bell for everyone 
on the network for all 50019 alerts (a server address change alert): 


ALERT 50019 ALL Off 





+ The following command turns off logging of all 50019 alerts. 


ALERT 50019 LOG Off 





1.5 ALIAS 


Purpose 


Use at the server console to define an alias. An alias is a user-defined keyword that represents a 
string. (The string can include both spaces and punctuation.) 


When you enter the keyword at the command line, the server replaces the word with the string. The 
keyword remains in effect until you restart the server. 





WARNING: If you are associating a keyword with a command string, make sure that you do not 
inadvertently leave out the keyword. If you do leave out the keyword, the first word in the command 
string becomes the keyword. If you then try to execute the command, the server will interpret it as a 
keyword, not as a command. 


For example, if you enter ALIAS LOAD INSTALL, LOAD becomes a keyword for INSTALL. If 
you then try to execute a LOAD command, the server displays a message saying that INSTALL has 
been replaced by NWCONFIG. 
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Syntax 


ALIAS [keyword[text] ] 


Parameter 


(no parameter) 
keyword and text 


keyword 


Using ALIAS 


Use to 


Display all defined 


aliases and the text they represent. 


Assign the keyword to the text. 


Delete the keyword as an alias for the text. 


Define an alias to reduce keystrokes or to avoid having to remember arguments in a long command 


string. 


Examples 


In the following example, ALIAS associates the keyword proto with a command to bind a protocol. 


ALIAS PROTO BIND IPX NE3200 NET=12345678 











To use the keyword, enter the alias at the server console prompt, instead of the BIND command: 


PROTO 


Executing ALIAS with no parameter displays a list of defined aliases, similar to the following: 





1. PROTO alias for <BIND IPX NE3200 N 


2. M alias for <MODULI 








ET=12345678> 








To revoke the keyword proto as an alias, you would enter the following at the server console prompt: 


ALIAS PROTO 
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1.6 ARP 


Purpose 


Use at the server console to display and modify the IP-to-Ethernet address translation table used by 
the address resolution protocol (ARP). The hostname can be specified by name or IP address and is 


associated with an interface. 


Syntax 
arp [-n] -i interface name hostname 
arp [-n] -a arp -d -i interface_name hostname 


arp -d -a arp -s -i interface name hostname ether addr [temp] arp -S -i 

interface name hostname ether addr [temp] arp -f filename 

Option Use To 

-n Show IP addresses as numbers to save DNS lookup time. (Normally, 
ARP attempts to display addresses symbolically.) 

-a Display or delete (with -d option) all of the current ARP entries. 

-d Delete an entry for the host named hostname. It can be combined with 
the -a option to delete all entries. 

-S Create an ARP entry for the host named hostname (if an ARP entry does 


not already exist for this hostname) with the Ethernet address 
ether_addr. The Ethernet address is given as six hex bytes separated by 
colons ( : ). The entry will be permanent unless the word temp is given in 


the command. 


-S Similar to -s, except that any existing ARP entry for the hostname will be 


deleted first. 


-f Cause the filename to be read and multiple entries to be set in the ARP 
table. Entries in the file should be of the form of interface_name 


hostname ether_addr [temp]. 


1.7 BASH 


Purpose 


Provides the BASH shell, including a variety of useful system utilities, on NetWare®. 
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Syntax 


bash.nlm 


Known Issues 


This section contains know issues, including issues where BASH might work differently than on 
NetWare. 


Limited Functionality on DOS Partitions 


Several BASH utilities rely on the existence of inode numbers for proper operation. Because files on 
the DOS partition do not have inode numbers, these utilities might exhibit strange behavior when 
accessing files on DOS partitions. 


These errors might limit functionality on DOS partitions, but should not result in server abends or 
data loss. 


Control Sequences 


Command Sequence Description 
Ctrl+Z (Suspend) Does not work and has no effect on processes. 
Ctrl+C (interrupt) Works only for processes actively reading from the keyboard or 


writing to the screen. 


Ctrl+\ (quit) Works only for processes actively reading from the keyboard or 
writing to the screen. 


Ctrl+D (end of file) Works only for processes actively reading from the keyboard or 
writing to the screen. 


Creating Mount Points to Access NetWare Volumes 


The BASH shell on NetWare uses POSIX style directory syntax similiar to Linux* when specifying 
pathnames. The foreward slash character (/) is a path separator. The backslash character (\) is not a 

path separator. Volume names may not be used to specify the location of files or directories (that is, 
it is invalid to type cd sys: /system). The sys: volume is specified by an initial foreward slash (/) 
in the path (for example, cd /system). To access other volumes at the BASH prompt, you must set 
up a pathtab file. 


To set up this file, modify (or create) sys: /etc/pathtab, placing each mount point and volume on 
a line similar to the following: 


[POSIXPath] [NetWare Path] 


For example: 
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/vols/data data:\ 
/mystuff data: \users\username 
/voll VOL1:\ 


The first example mounts the data volume to /vols/data in BASH, the second example mounts the 
users \username folder to /mystuff in BASH, and so on. In these examples, the directories / 
vols/data, /mystuff, and /vol1 must exist in the root of the sys: volume. 





NOTE: Creating mount points to remote systems is not supported. 


Supported BASH Commands 


The following BASH commands are supported in NetWare. For commands marked with *, see 
“Notes” on page 20. Information on using each of these commands can be obtained by running man 
[command] in BASH. 


ar arch awk basename bc 
bunzip2 bzip2 bzip2recover cal cat 
chgrp chmod* chown cksum clear 
cmp col colcrt colrm column 
comm cp cpio* csplit cut 
date de dd df diff 
diff3 dir dircolors dirname du 
echo egrep env envsubst expand 
expr factor false fgrep file 

find flex fmt fold funzip 
getopt gettext gnucore grep groups 
gunzip gzip head hostid hostname 
iconv id install join kill 

less lessecho lesskey line In* 
Logger look Is m4 make 
man man2html mcookie md5sum mkdir 
mkfifo mknod* mktemp more mv 
namei ngettext nice* nm nohup 
od paste patch pathchk pawk 
ping pr printenv printf ptx 
pwd ranlib readlink* rename renice* 
rm rmdir sdiff* sed seq 
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sh 

sort 
stty* 
tar* 

tr 
uname 
unzipsfx 
whereis 
yes 


zipsplit 


Notes 


sha1sum shred size sleep 
split stat strings strip 
sum sync tac tail 

tee test time touch 
true tsort tty ul 
unexpand uniq unlink unzip 
vdir vim wc wget 
which whoami xargs xxd 
zcat zip zipinfo zipnote 


The following table contains notes for any utility marked with * in the previous table: 


Utility 
chmod 


cpio 


In 


mknod 
nice 
readlink 
renice 
sdiff 
stty 


tar 


1.8 BIND 


Purpose 


Notes 


Modifies only the write bit on file permissions. 


Does not support archiving on remote systems or as a different user. Does not 
support file links. 


Hard links are supported on Novell Storage Services (NSS) volumes on NetWare 
6.5 and OES NetWare and Linux. For information, see “Managing Hard Links” in 
NW 6.5 SP8: NSS File System Administration Guide. Soft links are not supported in 
NSS. 


File links are not supported on NetWare Traditional volumes; it always returns an 
error. 


Supports only FIFOs on NetWare. 

Has no effect on NetWare. 

File links are not supported on NetWare. Always returns success. 
Has no effect on NetWare. 

Does not support interactive editing mode. 

Not all flags are supported or relevant on NetWare. 


Does not support the -z flag. 


¢ Use at the server console to link a communication protocol to a network board and its LAN 
driver. Unless you link the protocol to the board, the board can't process packets. 


20 NW 6.5 SP8: Utilities Reference 


+ You can also use INETCFG to link the network boards and their LAN drivers to the 
communication protocols. 





NOTE: Before you bind a protocol to a network board and LAN driver, you must install the 
network board and load the LAN driver. 





Syntax 


BIND protocol [TO] lan driver | board name [driver parameter...] [protocol 
parameter...] 


Bind Parameters 


Parameter Use to 

protocol Specify the communication protocol. 

lan driver | board name Specify either the LAN driver name or the network board name. 
driver parameter Identify a particular network board. 


If you specified a network board name, you do not need to specify driver 
parameters. 


If you specified a LAN driver and your server has more than one instance 
of the LAN driver loaded, use a driver parameter to specify the particular 
board the driver is running. 


For a list of valid driver parameters, see “Driver Parameters” on page 21. 


protocol parameter Specify the protocol parameters required for the protocol you are binding. 
See “Protocol Parameters” on page 22. 


Driver Parameters 


Depending on your system, one or more of the following parameters can be used to identify a 
particular board. 


Parameter Use to 


DMA=number Specify the DMA channel for the board. Use the same channel number 
you did when you loaded the driver. 


FRAME=number Specify the frame type for the board. Use the same type you did when 
you loaded the driver. 


INT=number Specify the interrupt number for the board. Use the same interrupt 
number you did when you loaded the driver. 


MEM=number Specify the memory address for the board. Use the same memory 
address you did when you loaded the driver. 


PORT=number Specify the I/O port for the board. Use the same I/O port number you did 
when you loaded the driver. 
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Parameter Use to 


SLOT=number Specify the network board by the lot it was installed in. Use this 
parameter with microchannel and EISA computers. Specify the same slot 
number you used when you loaded the driver. 


NODE=number Specify the node address for the board. This is a 12-digit hexadecimal 
number. 


Protocol Parameters 


Protocol/Parameter Use to 


For IPX protocol: Specify the IPX™ external network number. This is the number of the 


cabling system attached to the board. 
NET=number 


If the board is attached to an existing cabling system, use the same IPX 
external network number as used by other boards of the same frame 
type attached to this cabling system. Do not use the same number that 
was used by boards of a different frame type. 


If the board is attached to a new cabling system or if it is the first board of 
its frame type attached to the cabling system, you can enter any 
hexadecimal number of up to eight digits, as long as the number is 
different from all other network numbers. 


Remember that all boards of the same frame type attached to the same 
cabling system must use the same IPX external network number for that 
cabling system. 


For other protocols: Specify the information required by the particular protocol. 


Refer to the documentation 
that comes with the protocol. 
Or, consult the Novell® 
Support Connection™ Web 
site (http:// 
support.novell.com) or your 
Novell Authorized Resellers” 
representative. 


Using BIND 


+ You may not need to use the BIND command unless you want to add new LAN drivers after the 
initial server installation. 


+ You can also use INETCFG to load and bind LAN drivers. INETCFG places the BIND 
statements in the initsys.cfg file. 


¢ Ifyou use only the IPX/SPX™ protocol, you can add the BIND statement to the 
autoexec.ncf file. 
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Additional Information 


Topic See 


Binding a protocol to adriver Section 1.65, “INETCFG,” on page 71 


Viewing a list of Section 1.124, “PROTOCOL,” on page 152 
communication protocols 

Loading LAN drivers Section 1.82, “LOAD,” on page 87 
Purpose 


A command line utility that allows you to print from applications not designed for NetWare® print 
services. It sets up redirection parameters for printing output from your workstation; the NetWare 
DOS Requester™ software then redirects the workstation output from an LPT port to the specified 
network printer or file. 





NOTE: This utility is for use with legacy, queue-based Novell® print services. Novell iPrint is the 
default and preferred print system in NetWare6.0 and later. If you have legacy applications that print 
only to an LPT port, use iPrint's iCapture command to redirect LPT port output to an iPrint printer. 
For more information on iPrint, see the NW 6.5 SP8: ¡Print Administration Guide. 





Syntax 





CAPTURE P=printer_name|Q=queue_name L=1|LPT1 [options] 





Additional Information 


Topic See 
Using CAPTURE Setting Up CAPTURE for Applications Not Designed for Network Printing 


(http://www. novell.com/documentation/Ig/nw51/printenu/data/ 
hzm3nqx9.html) in NetWare 5.1 Queue-Based Printing. 


1.10 CDDVD 


Purpose 


Use at the server console to allow a CD or DVD disk to function as a Novell® Storage Services 
(NSS) volume. Immediately mounts the NSS volume. 
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This version of cddvd.nss replaces other CD modules used in previous NetWare releases. The 
NetWare 6 version of this module is cdrom.nim and should be used only for NetWare 6 installation 
because cdrom loads the nss module, cd9660.nss, and cdhfs.nss, and these modules are not 
needed in NetWare 6.5. The NetWare 5 version was named cdinst .n1m and should be used only for 
NetWare 5 installation. 


Syntax 


[LOAD] CDDVD 


Using CDDVD 





IMPORTANT: Use a CD or DVD disk as a read-only NSS volume. 





+ NSS supports CD and DVD volumes mounted with the Macintosh* and ISO 9660 name 
spaces. 


+ Also supports High Sierra, ISO 9660, and HFS (Apple*) file system formats. 
Additional Information 


Topic See 


NSS volumes “Managing CDs and DVDs as NSS Volumes (NetWare)” in the NW 6.5 
SP8: NSS File System Administration Guide 


1.11 CHARSET 


Purpose 


Use at the server console to change the code page currently used by the NetWare® server. 


Syntax 





CHARSET CPxxx [stay] 


Parameter Use to 
(no parameter) Display available code pages. 
CP xxx Specify the code page you want to use on the server, where xxx is the 


code page number. 


stay Leave the CHARSET code in memory. If you do not use the stay option, 
CHARSET unloads itself after it changes the code page. 
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Using CHARSET 


The following code pages are supported for NetWare: 437, 737, 850, 852, 855, 857, 860, 861, 863, 
865, 866, 869. 


Additional Information 


Topic See 


Changing code pages “Changing the Language NetWare Uses” in the NW 6.5 SP8: Server 
Operating SystemAdministration Guide 


1.12 Certificate Server 


Novell® Certificate Server enables the use of public keys cryptography and public key certificates 
in an eDirectory-enabled network. Certificate Server allows you to request, manage, and store public 
key certificates and their associated key pairs in the eDirectory tree, and establish and manage an 
eDirectory tree certificate authority (CA) that is specific to your eDirectory tree and to your 
organization. 


Certificate Server also works with most commercial certificate authorities and with the major 
certificate authority software. Certificate Server optionally generates PKCS #10 formatted 
certificate signing requests (CSR) that can be used by commercial or external CAs. 


Certificate Server consists of a PKI NLM™ and a snap-in module to ConsoleOne™. A network 
administrator uses ConsoleOne as the administration point for Certificate Server. 


Certificate Server uses the cryptography services provided by the Novell International Cryptography 
Infastructure (NICI). NICI is a modular infrastructure that offers replaceable cryptography engines. 
As such, a single version of Certificate Server can be used in NetWare installations throughout the 
world. Certificate Server derives all supported cryptography and signature algorithms, as well as 
supported key sizes from NICI. 


For additional information and procedures, refer to the Help system or to the Novell Certificate 
Server 3.3 Administration Guide. 


1.13 CLEAR STATION 


Purpose 


Use at the server console to clear a workstation connection. 





WARNING: If you use CLEAR STATION while the workstation is in the middle of a transaction or 
a file update, files might be saved with incomplete data. 





Syntax 


CLEAR STATION (nlall) 
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Parameter Use to 


n 


all 


Specify the connection number of the workstation you want to clear from 
the server. 


Clear all workstation connections to the server. 


Using CLEAR STATION 


+ 


To determine the connection number, from MONITOR's Available Options, select Connections 
> Connection Information at the server console or use NLIST on a workstation. 


You can use CLEAR STATION either after a workstation has crashed and left files open on a 
server or before you need to bring down the server. 


CLEAR STATION closes the workstation files and erases the server's internal tables for the 
station, including drive mappings not saved in the login script. 


The communication link between server and station is broken. 


Additional Information 


Topic 


See 


Removing server resources “Clearing a Workstation Connection” in the NW 6.5 SP8: Server 
from a workstation Operating SystemAdministration Guide 


Clearing a workstation “Clearing a Connection That Uses Auto Reconnect” in the NW 6.5 SP8: 
connection from a client that Server Operating SystemAdministration Guide 
has Auto Restart enabled 


1.14 CLIB 


Purpose 


The functionality of earlier versions of CLIB has been incorporated into a server library of C 
functions. The server library provides an ANSI-compliant runtime interface for other NetWare® 
Loadable Module™ (NLM™) programs. You cannot load the server library manually because it is 
autoloaded by the server operating system. The server library includes the following NLM 
programs, of which clib.nlm is one: 


+ 


+ 


+ 


fpsm.nlm —A library of functions providing floating-point support for NLM programs 
threads.nlm —A library of functions that constitute the NetWare threads package 
requestr.nim —A library of functions that make up the NetWare requester 


nimlib.nlm —A library of functions that provide basic runtime support for NLM programs, 
including POSIX-mandated functionality 


nit.nlm —A library of NetWare interface tools needed by some NLM programs 
clib.nlm —The standard C runtime library containing ANSI-mandated functions 


lib0.nlm —The message library, containing system and error messages for most of the other 
server library NLM programs 
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Using CLIB 


CLIB and the other modules of the server library are autoloaded by the server operating system. 


1.15 CLS 


Purpose 


Use at the server console to clear the console screen and move the console prompt to the top of the 
screen. 


Syntax 


CLS 


1.16 CLUSTER ALERT 


Purpose 


Use at the server console to specify whether you want a cluster resource to fail over, fail back, or 
start. 


The resource start, failover, or failback mode is set to manual and the resource is waiting to start on 
a node or to fail over or fail back to another node. Specify the resource name in the command and 
use the Yes|No switch to specify whether you want the resource to fail over, fail back, or start. 


Syntax 

















CLUSTER ALERT resource YES|NO 


1.17 CLUSTER CVB REBUILD 


Purpose 
Use at the server console to rebuild the CVB database to allow the use of duplicate pool names. 


This command is specific to implementations using Veritas. It causes Cluster Services to disregard 
the current Cluster Volume Broker (CVB) database. 


Syntax 


CLUSTER CVSBIND (ADD, DEL} resource IP address 
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1.18 CLUSTER DHCP 


Purpose 


Use at the server console to specify the eDirectory™ context where DHCP configuration 
information is stored. 


This command is useful if you have problems getting DHCP to function properly on a cluster. 


Syntax 


CLUSTER DHCP context 





1.19 CLUSTER DOWN 


Purpose 


Use at the server console to remove all cluster nodes from the cluster. This command has the same 
effect as executing the CLUSTER LEAVE command on every server in the cluster. 


Syntax 


CLUSTER DOWN 





1.20 CLUSTER JOIN 


Purpose 
Use at the server console to add a node to the cluster. 


This command adds the node to the cluster where the command is executed and makes the node 
visible to other servers in the cluster. Novell Cluster Services™ software must already be installed 
on a node for it to join the cluster. 


Syntax 


CLUSTER JOIN 
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1.21 CLUSTER LEAVE 


Purpose 


Use at the server console to remove the node from the cluster where the command is executed. The 
node will no longer be visible to other servers in the cluster. 


Syntax 





CLUSTER LEAVE 














1.22 CLUSTER MAINTENANCE 


Purpose 


Use at the server console to temporarily suspend the cluster heartbeat while hardware maintenance 
is being performed. 


This command is useful if you want to reset or power down the switch that the cluster is using to 
communicate with shared storage without bringing the cluster servers down. 


Syntax 

















CLUSTER MAINTENANCE On|Off 


1.23 CLUSTER MIGRATE 


Purpose 


Use at the server console to migrate the specified resource from the node where it is currently 
running to the node you specify in the command. 


The node you migrate the resource to must be running in the cluster and also be in the resource's 
assigned nodes list. 


Syntax 











CLUSTER MIGRATE resource node_name 
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1.24 CLUSTER OFFLINE 


Purpose 


Use at the server console to unload the specified resource from the node where it is currently 
ruming. 


Syntax 





CLUSTER OFFLINE resource 











1.25 CLUSTER ONLINE 


Purpose 


Use at the server console to start the specified resource on the most preferred node that is currently 
active. 


You can start the resource on a different node by specifying that node in the command. 


Syntax 


CLUSTER ONLINE resource node name 
[XXX] 


1.26 CLUSTER POOLS 


Purpose 














Use at the server console to list the NSS pools on the shared disk system that are accessible via 
Novell Cluster Services. 


Syntax 


CLUSTER POOLS 





1.27 CLUSTER RESOURCES 


Purpose 


Use at the server console to list all resources that currently exist in the cluster. The resources do not 
have to be online or running. 
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T 
n 


CLUSTER RESOURC 














1.28 CLUSTER RESTART 


Purpose 


Use at the server console to restart Novell Cluster Services software on all servers in the cluster after 
a specified time interval (in seconds). 


Syntax 





CLUSTER RESTART seconds 











1.29 CLUSTER STATS 


Purpose 


Use at the server console to display the node number, node name, and heartbeat information. You 
must switch to the log console screen to see cluster statistics. 


Syntax 





CLUSTER STATS {Display, Clear} 


1.30 CLUSTER STATUS 


Purpose 
Use at the server console to display the status of the specified resource. 


This includes the number of times the resource has been migrated or failed over to another server, 
the resource state, and the node where the resource is currently running. 


Syntax 


CLUSTER STATUS resource 
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1.31 CLUSTER VIEW 


Purpose 


Use at the server console to display the node name, cluster epoch number, master node name, and a 
list of nodes that are currently members of the cluster. 


Syntax 





CLUSTER VIEW 











1.32 COMPFIX 


Purpose 


Use the Compfix utility to repair compressed volumes. Load compfix.n1m on your server, then 
enter the Compfix command at the server console. 


Syntax 

compfix -[attribute] [-noheader] path [log volumel 

Parameter Use to 

path Specify the compressed volume or the individual file that has compression 
errors you want to repair. For example, volume or volume: lpath, where path 
includes the file name and is in the Long name space. 

log_volume If log_volume is specified, log data is written to 
log _volume:\compfix.txt. 
If log_volume is not specified, log data is written to volume: \compfix.txt. 

-noheader If -nheader is specified, no compression header will be validated. Use this on 
scanned volumes. 

-fs Fix compression statistics. 

-Ic List all corrupted compressed files. 

-df Diagnose an individual compressed file. 

-ff Fix an individual compressed file. 

-fc Fix all fixable corrupted compressed files on the volume. 

-bg Diagnose the background compression effect for an individual file. 

-CC Clears the Cannot Compress (Cc) attribute for files in the specified volume. or 


for a specified file. 
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Using COMPFIX to Repair Compressed Volumes 


The following table illustrates typical uses of the Compfix utility. 


Command Use to 


compfix -fs volume Fix compression statistics for the specified volume. 
The specified volume should be in maintenance 
mode in order for statistics to be computed 
correctly. 


compfix -Ic [-noheader] volume [log_volume] List all corrupted compressed files on the specified 
volume. 


compfix -df [-noheader] volume.\path [log_volume] Diagnose an individual compressed file. 
compfix -ff volume.\path Fix an individual compressed file. 


compfix -fc [-noheader] volume [log_volume] Fix all fixable corrupted compressed files on the 
specified volume. 


compfix -bg volume:\path [log_volume] Diagnose the background compression effect for 
an individual file. 


compfix -cc volume [log_volume] Clears the Cannot Compress (Cc) attribute for files 
in the specified volume. 


1.33 CONFIG 


Purpose 
Use at the server console to view the following: 


+ NetWare® server name, internal network number (server ID), server up time, and loaded LAN 
drivers 


¢ Driver version numbers, hardware settings, node (station) addresses, external network number 
of the cabling scheme, board name, frame type, and networking protocol for each network 
board 


¢ The server's eDirectory tree and bindery context 


Syntax 


CONFIG 


Using CONFIG 


¢ Before installing memory boards, network boards, or host bus adapters, execute CONFIG to 
see a list of hardware settings already in use by LAN drivers. 


+ On some systems, CONFIG may also display information about NetWare Loadable Module™ 
(NLM™) programs. The kind and amount of NLM information depends on the system. 


The following is an example of server information that CONFIG returns: 
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IPX internal network number: 0F42DB87 
Server Up Time: 235 Days 17 Hours 7 Minutes 6 Seconds 


Novell NE2000 
Version 3.65a December 22, 2002 
Hardware setting: 1/0 ports 300h to 31Fh, 
Interrupt 3h 





Node address: 00001B2709AF 
Frame type: ETHERNET_802.2 
Board name: NE2000_1 E82 
LAN protocol: IPX network 01010340 























Novell NE2000 
Version 3.65a December 22, 2002 
Hardware setting: 1/0 ports 300h to 31Fh, 
Interrupt 3h 
Node address: 00001B2709AF 
Frame type: ETHERNET II 
Board name: NE2000_1 EII 
LAN protocol: ARP 
LAN protocol: IP address 123.45.678.910 





























mask FF.FF.FF.O interfaces 1 mask FF.FF.FF.O interfaces 1 


Tree Name: DS JSBACH 


Bindery Context (s): 
.novell 


Additional Information 


Topic See 
Loadable modules Section 1.93, “MODULES,” on page 100 
Section 1.94, “MONITOR,” on page 102 


Configuration information for Section 1.94, “MONITOR,” on page 102 
storage device drivers 
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Topic See 


Server's external network Section 1.42, “DISPLAY IPX NETWORKS,” on page 45 
numbers 


1.34 CONLOG 


Purpose 
Use at the server console to 


+ Capture all console messages generated at the server while CONLOG is loaded. This includes 
system messages, eDirectory messages, the console output of all commands executed, and 
messages that announce RCONSOLE connections and discomnections. 


+ Write the messages to the default sys: \etc\console. log file (or to another file of your 
choice). 


+ View console messages for useful information although they scroll too quickly to read. 


+ Reveal errors that might occur during system initialization. 


Syntax 


[load] conlog [file=log filename] [save=backup filename] [archive=yes] 
[entire=yes] [maximum=max file size] [next=hh:mm:ss] | help 








TIP: Do not include a space before or after the equals sign (=). 





Parameter Use to 


help View a description of each CONLOG command option. You can load 
CONLOG using any combination of these options. 


file=/0g filename Specify the log file you want to use if you don't want CONLOG to write to 
the default log file sys: \etc\console.log. 


Note: You can change the name of the log file and store it in another 
directory. However, most configuration files are in the sys: \etc. 


save=backup file name Specify the filename in which you want to save the preexisting console 
log. 


By default, when you load CONLOG or when the console log file reaches 
its maximum size, the server deletes the existing console log file and 
creates a new file in its place. 


This parameter also enables autoexec.ncf to load CONLOG without 
overwriting the previous console log. Use this parameter at the 
command line or in autoexec.ncf if you want to examine the old 
console log for troubleshooting purposes. 


The backup file is in turn overwritten when a preexisting console log is 
saved just before it is replaced with a new file. 
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Parameter Use to 
archive=yes Archive up to 1000 console log files on your NetWare server. 


The first time you load CONLOG with this option, the server saves the 
existing console log file as the console.000 file. 


Then each time you load the CONLOG utility with the ARCHIVE option 
(or each time the console log file reaches its maximum when when 
CONLOG is loaded with the ARCHIVE option), the server increments the 
extension of the archive file by 1—console.001, console.002, etc. 


entire=yes Capture the lines already on the screen at the time CONLOG is loaded. 


Without this parameter, CONLOG starts logging with the next output to 
the console after it is loaded. 


maximum=max file size Specify the maximum size, in kilobytes, of the log file. 


If the log file exceeds the max file size, it is deleted—or renamed if 
backup filename was specified. In either case, logging starts over with an 
empty log file. 


Important: If a maximum file size is not specified, there is no limit. 


next=hh:mm:ss Specify the time of day (24-hour clock) with hour, minutes, and seconds 
when the server archives the existing console log and creates a new file. 


This option allows you to know the beginning time of a backup file or an 
archive file. 


Use this option with save or archive. 


Using CONLOG 


You can view the console log from a workstation with any text editor. Any logged-in user with the 
Read right to the sys: \etc directory can view console log files in this way. 


To view the console log file from the server console, use the VIEW utility or the INETCFG utility. 


+ Console messages can reveal errors that occur during system initialization. 


+ The command LOAD CONLOG is typically added to the autoexec.ncf file, as in the 
following example: 


file server name netw5_svr 

ipx internal net c92556e 

load conlog 

load remote 

load rspx 

Where you place the load conlog command in autoexec.ncf determines which console 
messages the server saves in the console log file. To record as many console messages as 


possible, place the LOAD CONLOG command near the beginning (immediately after the FILE 
SERVER NAME, as above). Use EDIT or NWCONFIG to modify the autoexec.ncf file. 
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Examples 


¢ To start capturing console messages during system initialization, enter 


[load] conlog 


+ To load CONLOG but save the current log file as clog. bak and limit the size of console.log 
to 100 KB, enter 


[load] conlog save=clog.bak maximum=100 


+ To load CONLOG, limit the size of console. log to 200 KB, and schedule existing console log 
files for daily archiving at 6:00 a.m., enter 


[load] conlog maximum=200 archive=yes next=06:00:00 


+ To stop capturing console messages, enter 


unload conlog 


Additional Information 


Topic See 


Viewing console log file Section 1.177, “VIEW,” on page 275 
Section 1.65, “INETCFG,” on page 71 


Editing autoexec. ncf file “Using Server Batch Files” in the NW 6.5 SP8: Server Operating 
SystemAdministration Guide 


1.35 ConsoleOne 


Purpose 


ConsoleOne® is a Java*-based tool for managing your network and its resources. By default, 
ConsoleOne lets you manage: 


¢ eDirectory™ objects, schema, partitions, replicas, and rights 


+ NetWare file system resources 


If you install other Novell products, additional functionality might be added to ConsoleOne. For 
example, if you install Novell eDirectory, the capability to configure the LDAP interface to 
eDirectory is snapped in to ConsoleOne automatically. 
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ConsoleOne is designed like a file manager utility: in the left window pane you browse containers, 
and in the right window pane you work with the resources in those containers. 
Starting ConsoleOne 
To start ConsoleOne on a NetWare server, do either of the following: 
+ On the servertop (server GUI), click Novell > ConsoleOne. 
+ At the system console prompt, type CISTART. 
To start ConsoleOne on a Windows workstation: 


1 Map a drive to the sys: volume of a NetWare server. 


2 On the mapped drive, go to public\mgmt\consoleone\1.2\bin, and then run 
consoleone.exe. 


If ConsoleOne is installed locally on the Windows computer, simply double-click the ConsoleOne 
icon on the desktop. 


If ConsoleOne is installed remotely on a NetWare or Windows server and you don't have a shortcut 
to that installation, do the following: 


1 In Windows Explorer, find the mapped or shared drive that represents the server volume where 
ConsoleOne is installed and then browse to the folder where ConsoleOne is installed. 


By default, this is: 


Windows c:\novell\consoleone\1.2 


NetWare sys:public\mgmt\consoleone\1.2 





IMPORTANT: You must browse for ConsoleOne on a drive that is mapped to a letter, not a 
UNC path. 





2 Inthe bin subfolder, double-click consoleone.exe. 


3 (Optional) For future use, create a shortcut on your desktop to the remote consoleone.exe 
file. 


To start ConsoleOne on Linux* or Solaris*: 


At the system prompt of a local session or an X terminal (remote) session, enter the following 
command: 


/usr/ConsoleOne/bin/ConsoleOne 


Additional Information 


Topic See 


Why use ConsoleOne? ConsoleOne User Guide (http:/Awww.novell.com/ 
documentation/Ig/consol13/index.html) 


38 NW 6.5 SP8: Utilities Reference 


1.36 CPUCHECK 


Purpose 


Use CPUCHECK at the server console to display per-processor information, including processor 
number, processor clock speed (MHz), processor ID, processor version and subversion, amount of 
Ll and L2 cache memory, and current revision number. 


Syntax 


cpucheck [processor number...] 


Using CPUCHECK 


When you run CPUCHECK, the output for a uniprocessor server is similar to the following: 


Processor Speed 199 MHZ, CPUID 619:FBFF 
Family 6, Model 1, Stepping 9 
L1 cache: 16K Bytes, L2 cache: 256K Bytes 
Current Revision: D1 


To verify information for a particular processor, specify the processor number. 


Additional Information 


Topic See 


Displaying information on Section 1.45, “DISPLAY PROCESSORS,” on page 49 
processors 


Checking processor's clock Section 1.157, “SPEED,” on page 253 
speed 


1.37 CX 


Purpose 


Use at a workstation to view or change your eDirectory™ context, or to view containers and leaf 
objects in your eDirectory tree structure. 


Syntax 





CX [new context] [/option...] [/? | /VER] 
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Parameter 

(no parameter) 
new context 
loption 

1? 


IVER 


Using CX 


Use to 

View the current context. 

Move to a new context or specify the context you want for an option. 
Replace option with any available option. See “CX Options” on page 40. 
View online help. All other parameters are ignored when /? is used. 


View the version number of the utility and the list of files it uses to 
execute. All other parameters are ignored when /VER is used. 


+ CX is similar to the DOS CD and DIR commands in that CX allows you to change contexts and 
view all objects below a given container. 


+ CX doesn't recognize spaces in object names. If you have spaces in container names, put 
quotation marks around the names or use underscores (_) in place of the spaces. 


For example, for container CORPORATE ADMIN, type Corporate Admin or 


Corporate Admin. 


CX Options 


Option 
IR 
IT 


ICONT 


IA 
IC 


Examples 


Use to 
List containers at the root level, or change context in relation to the root. 


List containers below the current context or a specified context in a tree 
structure. 


List containers at the current context or a specified context in a vertical 
list with no structure. 


Include all objects at or below the context. Use with /T or /CONT. 


Scroll continuously through output. 


+ To see your context in eDirectory before logging in, type 


CX 


+ To set a new context from the root 


¢ Place a period in front of the new context you type, or 


+ Enter the proper number of trailing periods to reach the root level, or 


+ Use the /R option. 


+ To back up one level in the eDirectory tree, type 


CX . 


(You must put a space between the command and the trailing period.) 
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+ To go down two levels from PROVO.NOVELL to SYSTEM.ENGINEERING. 
PROVO.NOVELL, type 


cx system.engineering 


¢ To change your current context from TESTING. PROVO.NOVELL.US to 
SYSTEM.MARKETING. PROVO.NOVELL.US, type 


cx .system.marketing.provo.novell.us 
or 
cx system.marketing. 
¢ To change to the root when your context is TEST.PROVO.NOVELL, type 
CX . 
or 
CX /R 


+ To change the complete context from TESTING. PROVO.NOVELL to 
TESTINGPARIS.NOVELL, type 


cx .testing.paris.novell 
+ To show all containers in the current context, type 
CX /CONT 
+ To show all containers in the context SALES.NOVELL in a tree structure, type 
cx .sales.novell /t 
+ To show all containers and leaf objects in the current context in a tree structure, type 


cx /t /a 


1.38 DISABLE LOGIN 


Purpose 


Use at the server console to prevent users from logging in. 


Syntax 


disable login 


Using DISABLE LOGIN 


¢ Use this command to prevent users from logging in when you are making repairs, backing up 
files, or loading software. 


+ Users already logged in aren't affected. However, a user who logs out can't log in again until 
you execute ENABLE LOGIN. See Section 1.53, “ENABLE LOGIN,” on page 57. 
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1.39 Dismount 


Purpose 


Use at the server console to make a volume unavailable to users. 


Syntax 


dismount volume_name 


Parameter Use to 


volume_name Specify the name of the volume you want to dismount. 


Using Dismount 
* Dismount allows you to maintain or repair a volume and to upgrade disk drivers while the 
NetWare server is up. 


+ Use this command to dismount all volumes residing on a removable drive before you remove 
the drive. 


+ If you are running out of memory and cannot add more RAM, consider dismounting a volume 
that is used infrequently. 


Mounted volumes take up memory allocated for file caching and thus affect server 
performance. NSS volumes use much less memory than Traditional volumes. 


Additional Information 


Topic See 
Dismounting a volume “Mounting and Dismounting an NSS Volume (Linux)” in the NW 6.5 SP8: 


NSS File System Administration Guide. 


1.40 Display Environment 


Purpose 


Use at the server console to display current search paths and current values of the settable server 
parameters, along with their default values and range of valid values. 


If you use a color monitor as your console, the parameter name appears in white and its current 
value in yellow. 





NOTE: DISPLAY ENVIRONMENT displays only settable server parameters that are not marked 
as hidden. 
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Syntax 


display environment 


Using DISPLAY ENVIRONMENT 


DISPLAY ENVIRONMENT lists the server's current search paths first and then the settable server 
parameters follow. 


The following example illustrates a sample of the command display. Note that the sample begins 
with the Communications Parameters, just as SET and MONITOR do. 














PATH=\\BREMEN\SYS\SYSTEM\; C: \NWSERVER; \\BREMEN\SYS\JAVA\BIN\ ; \\BREMEN 
\SYS\JAVA\NWGEX\; 









































SPX Maximum Window Size: 0 

TCP Defend Land Attacks: On 

TCP Defend SYN Attacks: Off 

IP Wan Client Validation: Off 

Allow IP Address Duplicates: Off 

IPX Router Broadcast Delay: 0 

Reply To Get Nearest Server: On 

IPX NetBIOS Replication Option: 2 

Use Old Watchdog Packet Type: Off 

Number of Watchdog Packets: 10 

Delay Between Watchdog Packets: 59.3 seconds 
Delay Before First Watchdog Packet: 4 minutes 
Console Display Watchdog Logouts: Off 

aximum Packet Receive Buffers: 500 

inimum Packet Receive Buffers: 128 

aximum Physical Receive Packet Size: 4224 
New Packet Receive Buffer Wait Time: 0.1 seconds 
IPX CMD Mode Routing: Off 

Load Balance Local LAN: Off 

Garbage Collection Interval: 5 minutes 

Alloc Memory Check Flag: Off 

Reserved Buffers Below 16 Meg: 300 

Read Ahead Enabled: On 

Read Ahead LRU Sitting Time Threshold: 10 seconds 
Minimum File Cache Buffers: 20 

Maximum Concurrent Disk Cache Writes: 4000 
Dirty Disk Cache Delay Time: 0.1 seconds 





























Additional Information 


Topic See 


Listing server parameters Section 1.44, “DISPLAY MODIFIED ENVIRONMENT,” on page 48 
settings that have been 
modified from default values 


Restoring server parameter Section 1.140, “RESET ENVIRONMENT,” on page 168 
settings to their default values 
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Topic See 


Descriptions of settable server Section 1.154, “SET,” on page 188 


parameters 

Printing server parameter “Printing Current Parameter Values to a File” in the NW 6.5 SP8: Server 
settings to a file Operating SystemAdministration Guide 

1.41 DISPLAY INTERRUPTS 

Purpose 


Use to display currently assigned hardware interrupts, interrupt handlers (also called Interrupt 
Service Routines or ISRs), and interrupt statistics. 


Syntax 





DISPLAY INTERRUPTS [option] 


Option Use to 

(no option) Display interrupts currently in use. 

n... Display one or more interrupts by number. 

ALL Display all interrupts. 

PROC Display per-processor interrupt information. 

ALLOC Display allocated interrupts. 

REAL Display interrupts that occurred while the OS was in real mode and that 


were then reflected back to protected mode to be serviced. 


Using DISPLAY INTERRUPTS 


When a processor is taken offline or when an interrupt handler (ISR) is removed, the detailed 
statistics pertaining to that processor or interrupt handler are, by default, removed from memory. 


To retain per-processor interrupt handler statistics for offline processors or to retain the total 
interrupt contribution from a previously loaded handler, change the SET parameter Set Auto Clear 
Interrupt Statistics to Off. 


Examples 


To display interrupts currently in use, enter DISPLAY INTERRUPTS with no options. The display 
is similar to the following sample: 


Total Interrupt Count For All Processors: 940208 
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Interrupt 0: OS Allocated Bus Interrupt 292828 
Interrupt Handler: Timer 0 Interrupt Handler 


Interrupt 1: OS Allocated Bus Interrupt 375 
Interrupt Handler: Keyboard Interrupt Handler 375 


Interrupt 5: OS Allocated Bus Interrupt 86229 
Interrupt Handler: E100B Hardware ISR 94829 





Interrupt 9: OS Allocated Bus Interrupt 30691 
Interrupt Handler: NPA Environment 30691 





Interrupt 12: OS Allocated Bus Interrupt 1299 
Interrupt Handler: PS/2 Mouse Port Interrupt 1299 


Interrupt 39: MPS14.PSM Allocated Local Interrupt 0 
Interrupt Handler: APIC Spurious Interrupt Handler 


Additional Information 


Topic See 


Registered system interrupts MONITOR Available Options > Kernel > Interrupts 
and interrupt information 


1.42 DISPLAY IPX NETWORKS 


Purpose 


Use at the server console to list all networks and assigned network numbers that the NetWare® 
server's internal router recognizes. 


Syntax 


DISPLAY IPX NETWORKS 
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Using DISPLAY IPX NETWORKS 


DISPLAY IPX NETWORKS lists the IPX external network numbers of networks recognized by this 
server. The following example illustrates a portion of the command display: 


0000000D 2/3 00000016 5/11 00000070 5/11 


00000097 6/12 000000ED 5/6 000000F1 3/3 





000000FF 2/2 00000101 6/11 00000111 5/11 


000003E8 5/11 00000456 6/12 00000666 5/17 





Each address is followed by two numbers separated by a slash: 


¢ The first number is the number of routing hops between your server and the network at that 
address 


+ The second number is the number of ticks (1/18th of a second) required to send a packet to that 
address 


Additional Information 


Topic See 


Listing servers on the network Section 1.43, “DISPLAY IPX SERVERS,” on page 46 


1.43 DISPLAY IPX SERVERS 


Purpose 


Use at the server console to view a list of IPX servers and services being advertised by Service 
Advertising Protocol (SAP) packets. 


Syntax 


display ipx servers [string] 
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Parameter Use to 


(no parameter) Display a list of all servers the IPX internal router is aware of. 
string Specify the name of the server you want to display information about. 


The string can include an asterisk (*) as the last character. In this case, 
the system displays a list of all servers whose names begin with the 
string. 


For example, DISPLAY IPX SERVERS D* displays a list of all servers 
with names beginning with the letter D. 


Using DISPLAY SERVERS 
¢ Lists server address names for services such as the following: 


File services 

eDirectory™ 

Print services 

Storage Management Services™ (SMS™) 

Services for Structured Query Language (SQL) servers 


+ Also displays eDirectory trees and network addresses. A server can be displayed many times, 
once for each service that it advertises. 


For example, a NetWare® server running IPX would be listed at least twice because it would 
use SAP both for eDirectory and for advertising file services. 


The following sample shows the beginning of a typical display: 


AAA 4 ACAPULCO 5 AIRBUS 7 


ANATOL 4 ASSURE1 4 ASSURE2 4 











BEAST 3 BANCROFT 6 BREMEN 3 














The number listed after the server name indicates the number of routing hops between this 
server and the listed servers. Your server is indicated by 0 hops. 


Servers more than 16 hops away aren't recognized. 


Additional Information 


Topic See 


Listing networks Section 1.42, “DISPLAY IPX NETWORKS,” on page 45 


Utilities 


47 


1.44 DISPLAY MODIFIED ENVIRONMENT 


Purpose 


Use at the server console to display all server parameter settings that have been modified from 


default values. 


Syntax 

















DISPLAY MODIFIED ENVIRONMENT 


Using DISPLAY MODIFIED ENVIRONMENT 


DISPLAY MODIFIED ENVIRONMENT displays the current values of the server parameter 
settings that have been modified from their default values. Default values are also displayed. When 
parameter values are changed, the new values are persistent. 


The following example shows a portion of the command display: 


Maximum Concurrent Disk Cache Writes: 


Current 
Default 


Setting: 4000 
Setting: 200 


Dirty Disk Cache Delay Time: 


Current 
Default 


Auto Restart 
Current 
Default 


Default Tree 
Current 
Default 


Setting: 0.1 seconds 
Setting: 3.3 seconds 


After Abend: 














Setting: 0 
Setting: 1 

Name: 

Setting: DT BREMEN 
Setting: 
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Additional Information 


Topic See 


Listing server parameters and Section 1.40, “Display Environment,” on page 42 
display their current settings 
with defaults and limits 


Restoring server parameter Section 1.140, “RESET ENVIRONMENT,” on page 168 
settings to their default values 


Printing server parameter “Printing Current Parameter Values to a File” in the NW 6.5 SP8: Server 
settings to a file Operating SystemAdministration Guide 

1.45 DISPLAY PROCESSORS 

Purpose 


Use at the server console to display the status of all processors installed in the server computer and 
available to the NetWare® operating system. 


Syntax 


display processors [ n ...] 


Parameter Use to 
(no parameter) Display online or offline status of all processors. 
n... Specify the number of the processor for which you want to display status. 


By using spaces to separate processor numbers, you can display the 
status of more than one specific processor. 


Using DISPLAY PROCESSORS 


DISPLAY PROCESSORS lists the online or offline status of all processors. The following example 
illustrates the command display when all four processors are online: 

















Processor 0 is ONLINE. 
Processor 1 is ONLINE. 
Processor 2 is ONLINE. 
Processor 3 is ONLINE. 





If you have a color monitor for your console, the output appears in green for online processors and 
in red for offline processor. 
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Additional Information 


Topic See 

Stopping secondary Section 1.162, “STOP PROCESSORS,” on page 258 
processors 

Starting secondary Section 1.161, “START PROCESSORS,” on page 257 
processors 

Starting processors SET “Multiprocessor Parameters” on page 220 


automatically when Platform 
Support Module is loaded 


Adjusting load balancing SET “Multiprocessor Parameters” on page 220 
threshold 


Displaying per-processor Section 1.41, “DISPLAY INTERRUPTS,” on page 44 
interrupts and interrupt 
information 


Displaying per-processor Section 1.36, “CPUCHECK,” on page 39 
information 


Displaying per-processor Section 1.94, “MONITOR,” on page 102 


information 
MONITOR Available Options > Kernel > Processors 


1.46 Down 


Purpose 
Use at the server console to execute an orderly shutdown of the NetWare® server before either 
+ Turning off power to the server, or 


+ Rebooting NetWare with new parameters or accessing DOS files 


Syntax 


down 


Using Down 


+ Down ensures data integrity by writing cache buffers to disk, closing files, and updating 
Directory tables and File Allocation Tables. 


If you turn off power without using DOWN first, changes held in cache buffers will be lost. 


* Down executes a shutdown .ncf file if one is present. 
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For example, although most modules, including those in protected address spaces, unload 
automatically when you down or restart the server, some modules might require that you 
unload them individually first. 


You can unload them manually at the server prompt. Or you can simply place the unload 
commands in a shutdown .ncf file. (Run the modules command to determine address spaces 
for specific modules.) 


Additional Information 


Topic See 


Bringing down the NetWare “Starting and Stopping the Server” in the NW 6.5 SP8: Server Operating 
server SystemAdministration Guide 


Restarting the server without Section 1.144, “Restart Server,” on page 171 
rebooting it 


Creating server batch files “Using Server Batch Files” in the NW 6.5 SP8: Server Operating 
SystemAdministration Guide 


Determining the address Section 1.93, “MODULES,” on page 100 
space a module is loaded in 


1.47 DSDiag (DS diagnostics) 


Purpose 

Use at the server console to 
+ Document your current eDirectory configuration 
+ Check the health of your eDirectory tree 
+ Diagnose or pinpoint problems 

Additional Information 


DSDiag has been incorporated into iMonitor, and is no longer avaible on NetWare. See Section 1.64, 
“¡Monitor,” on page 71 for more informaiton. 


1.48 DSMerge 


Purpose 
Use at the server console to 


+ Merge the roots of two separate eDirectory trees 


+ Rename a tree to verify that all servers in the eDirectory tree are responding properly and have 
the same tree name 


¢ View time synchronization information and display the time server for all servers in the tree 


¢ Graft a single server source tree's Tree object under a container specified in the target tree 
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Syntax 


[load] [path] dsmerge 


Parameter Use to 


path 


Specify the path to dsmerge . n1m if you moved it from the 
default directory of sys : system. 


Things to Consider before Merging Trees 


+ 


Before merging two trees, make sure that time synchronization is operating correctly and that 
both trees are synchronized. DSMerge allows the merge to complete if the time on the source 
tree is behind 5 minutes of the target tree time, but not ahead of the target tree time. 


When merging very wide trees with long subordinate names or many subordinate names (500 
or more), the error -251 OS: ERR_NO_SUCH_PROPERTY is returned. Rename the objects 
using shorter names or reduce the number of subordinates. 


When preparing a NetWare 4.1x tree for a merge, use DSRepair v4.56 or later to import the 
schema. Previous versions of DSRepair import the schema for NetWare incorrectly. 


Partition synchronization operations generally complete quickly after a merge, but in some 
cases can take several hours. Use DSRepair to check synchronization status before performing 
a merge to ensure that replica synchronization processes are occurring properly. 


If you will merge trees where both your source and target tree contain Security containers, one 
of the Security containers must be deleted to successfully complete the merge. The Security 
container is located in [Root] of the eDirectory tree. Deleting the Security container could have 
serious consequences for the eDirectory tree Certificate Authority and Key Material objects. 
See the Novell Certificate Server 3.3 Administration Guide for more information on this issue. 


Additional Information 

Topic See 

Configuring time synchronization NW 6.5 SP8: Network Time Synchronization 
Administration Guide 

Using DSMERGE F1 in the utility 

Merging Novell eDirectory trees Novell eDirectory 8.8 Administration Guide 


1.49 DSRepair 


Purpose 


Use at the server console to maintain and repair the database of a Novell eDirectory tree. DSRepair 
performs the following operations: 


+ 
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Correct eDirectory problems such as bad records, schema mismatches, bad server addresses, 
and external references. 


Utilities Reference 


+ Make advanced changes to the eDirectory schema. 


+ Check the structure of the database automatically without closing the database and without user 
intervention. 


+ Check the database operational indexes. 

+ Reclaim free space by discarding empty records. 

¢ Repair the local database. 

¢ Repair replicas, replica rings, and Server objects. 

+ Analyze each server in each local partition for synchronization errors. 
+ Locate and synchronize objects in the local database. 


If the server abends, use DSRepair to verify the integrity of the eDirectory database after restarting 
the server. 


Syntax 


[LOAD] [path] DSREPAIR [-U|-A] 





Option Use to 
path Specify the path to dsrepair.nlm if you are not running it from 


sys:system. 


-U Perform a full unattended repair and exit automatically upon 
completion. 
-A Make advanced (and possibly destructive) replica and partition 


options available in the DSRepair menus. 


DSRepair Options 


+ “Unattended Full Repair” on page 53 

+ “Time Synchronization” on page 54 

+ “Report Synchronization Status” on page 54 
+ “Repairing Network Addresses” on page 54 


Unattended Full Repair 


An unattended full repair performs all possible repair operations that do not require your input. This 
is the suggested means of repair unless you are told by Novell technical support to perform other 
operations manually. 


The log file is displayed by default when the repair completes. The log file is a text file named 
dsrepair.log and it is stored in the sys : system directory. 
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Time Synchronization 


Select this option to determine whether this server has synchronized its clock with other servers on 
the network. Because replica synchronization depends on time stamps, replica synchronization can 
be delayed until time synchronization is achieved. 


When changing a read/write replica to a master, make sure the time synchronization on the server is 
working correctly so the changes will happen in a timely manner. 





NOTE: eDirectory operates on “synthetic time” if true synchronization has not been accomplished. 
Synthetic time is generated when the time stamp on a replica of a partition is ahead of the actual 
server time. eDirectory conducts its normal operations fully on synthetic time, but some partition 
and replication work can be delayed until time is synchronized. 





If time is not synchronized to the network, server clocks are automatically adjusted in small 
increments until synchronization is achieved. In this case, no user intervention is required. 


The Time Synchronization option of DSRepair generates a warning message if synchronization has 
not completed within 12 hours. In this case, you should troubleshoot your time server configuration. 
Report Synchronization Status 


This option gets replica synchronization status from all servers that hold replicas of the same 
partitions held on this server. It also reports other eDirectory errors associated with those servers or 
replicas. Use this option to determine whether you need to repair replicas, resolve communications 
problems, or initiate some other action. 


Error code descriptions are in the Novell Error Codes Reference Guide. 


Repairing Network Addresses 


Repair Network Addresses (RNA) checks the network address for every server in the local 
eDirectory database files by searching the local SAP tables if IPX is enabled or by using SLP in an 
IP-only environment. 


Each address is then compared to the NetWare Server object's Network Address property and the 
address record in each Replica property of every partition [ROOT] object. If the addresses are 
different, they are updated to be the same. 


If the server address is not found in the SAP table or through SLP, no other repair is performed. 


Additional Information 


Topic See 

Using DSREPAIR F1 in the utility 

Repairing the Novell eDirectory Novell eDirectory 8.8 Administration Guide 
database 
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1.50 DTRACE 


Purpose 


DTRACE is a menu-driven trace utility used with U.S. Robotics* ISDN Allegra adapter with 
fxpri.lan and fxbri.lan ISDN drivers. 


1.51 EDIRUTIL 


Purpose 


The Novell® eDirectory™ Management Toolbox (eMBox) lets you access all of the eDirectory 
backend utilities remotely as well as on the server. eMBox works with Novell ¡Manager to provide 
Web-based access to eDirectory utilities such as DSRepair, DSMerge, Backup, and Restore, as well 
as to Service Manager functionalities. All functions are accessible, either on the local server or 
remotely, through a command line client. You can perform tasks for multiple servers from one server 
or workstation using the eMBox Client. 


The EDIRUTILutility gives you a shortcut to running the eMBox Client. It points to the Java” 
executable and the default location where the eMBox Client is installed with eDirectory. And for 
NetWare® software, it includes the necessary -ns option (which is a Java option on NetWare 
meaning “new screen”). 


You must have access behind the firewall to use the eMBox command line client for the servers you 
want to manage—so if you are remote, you'll need VPN access. 


Syntax 


edirutil -i 


Using EDIRUTIL 


To display the eMBox general command line help before going in to the eMBox Client, do the 
following: 


+ NetWare and UNIX: At the command line, enter edirutil -? 


+ Windows: Run drive\novell\nds\embox\edirutil.exe -? 


To display the eMBox interactive command line help while you are in the interactive mode, at the 
eMBox Client prompt, enter a question mark (?). For example: 


eMBox Client> ? 


To use the eMBox Client on a machine other than an eDirectory server: 


1 Copy the eMBoxClient. jar file from an eDirectory server to your machine. 


+ NetWare: sys: \system\embox\eMBoxClient.jar 
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+ Windows: \novell\nds\embox\eMBoxClient.jar 
+ UNIX: /usr/1lib/nds-modules/embox/eMBoxClient.jar 
2 Make sure the machine has Sun” JVM? 1.3.1 or later installed. 


3 Make sure you have access behind the firewall to use the eMBox command line client for the 
servers you want to manage. 


You can't use the EDIRUTIL command on a workstation as a shortcut to getting in to the eMBox 
Client in interactive mode as you can on a server. You must either set up the environment once in 
your path and class path or enter it manually each time. 


Additional Information 


Topic See 


eDirectory Management Toolbox Novell eDirectory 8.8 Administration Guide 


1.52 EDIT 


Purpose 


Use at the server console to create or modify a text file on a boot, DOS, USB, or NetWare® 
partition. 


Syntax 


[LOAD] [path]EDIT [pathname] 





Parameter Use to 

path Specify the path to edit .n1m if you moved it from the default directory 
(c: \nwserver). 

pathname Specify the pathname of the file you want to edit. 

Using EDIT 


+ Ifyou don't enter a pathname when you load EDIT, a dialog box displays where you can enter 
the pathname. 


You can also press Insert to display a browse window from which you can select a file. To see 
the contents of a volume or directory, select the volume or directory name in the window and 
press Enter. Use the arrow keys to scroll up and down the list of files and directories. When the 
file you want to edit is selected, press Enter to display the file. 


¢ Ifthe file doesn't exist, EDIT displays a prompt asking if the file should be created. 


+ When you create a new file, the file can be no larger than 8 KB. Each time you open the file 
after that, you can increase the file size by up to 4 KB. 


+ You can use EDIT to view read-only files. 
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+ EDIT is particularly useful for creating .ncf batch files that automatically execute server 
commands. 


¢ You can use the following function keys: 


Function Key Usage 

Ctrl+F Search for text in a file. 

Ctrl+R Search for and replace text in a file. 

F3 Find the next text previously searched. 

Esc Exit the file. If changes have been made, you are 


prompted whether to save the changes. 


Additional Information 


Topic See 


Creating and editing text files “Using EDIT to Create and Edit Text and Batch Files” in the NW 6.5 SP8: 


on the server Server Operating SystemAdministration Guide 
1.53 ENABLE LOGIN 
Purpose 


Use this command at the server console prompt to 


+ Reenable the login function after using DISABLE LOGIN. 


+ Enable the supervisor account when the account has been locked by the intruder detection 
function. (The supervisor account exists only on bindery-based servers or on NetWare® 4 
servers when bindery emulation is active.) 


Syntax 








ENABLE LOGIN 








Using ENABLE LOGIN 


You don't need to use ENABLE LOGIN when you start the NetWare server or workstation. The 
login function is enabled during the startup process. 


1.54 Enhanced SBACKUP 


Purpose 


Use at the server console to back up and restore Storage Management Services™ (SMS™) targets 
such as eDirectory, binderies, the file system, or hard disks on workstations to media for off-site 
storage. 
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Starting Enhanced SBACKUP 


Certain prerequisites must be met before loading the backup software. For more information, see 
NW 6.5 SP8: Storage Management Services Administration Guide. 


A series of NetWare modules must be loaded in sequence: 
1. Type smdr. This loads the backup submitter so the backup software on the server can 
communicate with the TSA. 

. Enter the full context of your user name. 

. Enter the administrator password. 

Type tsa600. This loads the TSA for NetWare 6. 

Type smsdi. 

Type qman. This creates a queue. 


Type sbsc. 


oN Dw Rw HN 


Type sbcon. This loads the backup engine. 


You can also back up data from a Windows* 95* or Windows NT* workstation by starting 
NWBACK32 (sys: public\nwback32.exe). 


Using Enhanced SBACKUP 


When you type sbcon, the backup engine loads, and the main menu appears. Make your selections 
from this screen. Press F1 for Help. 


Additional Information 


Topic See 

Storage Management NW 6.5 SP8: Storage Management Services Administration Guide 
Services 

Purpose 


This legacy DOS utility can be used at a workstation to manage files and directories on NSS for 
NetWare volumes. FILER works with the file system; it doesn't affect eDirectory objects. 


Filer is a client-side application, not a server-side application. Install the Novell Client for Windows 
on your workstation, then use the Novell Map Network Drive option in the client menu to map a 
local drive letter to the sys: /public directory. Open a DOS Command Prompt window, cd to the 
mapped drive, then issue the filer command from the command line. 


Syntax 


Figure 1-1 on page 59 shows the functions of FILER. 
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Figure 1-1 FILER Functions 


Allows you to: 


e Modify or view files 

e Change current directory or 
server 

e Modify, add, or view directories 

` Modify, add, or view 
subdirectories 
Modify or view rights for files 
and directories 
View trustees for files and 
directories 


Allows you to view files or directories 
according to a search pattern. 


Allows you to set your current 
context, volume object, and new path. 


Allows you to view: 


Owner 

Creation date 

Creation time 

Volume type 

Total kilobytes available 
Maximum directory entries 
Entries available 

































1.56 FLAG 


Purpose 


Use at a workstation to 


+ View or modify file and directory attributes to determine which operations can be performed 


with the file or directory 


+ Modify the owner of a file or directory 


¢ View or modify the search mode of executable files to determine how the program uses search 


drives when looking for a file 


Syntax 





SYS:PUBLIC\FLAG.EXE path [[+ 














Manage files and directories 


Select Current Directory 
View volume information 
Salvage deleted files 
Purge deleted files 

Set default filer options 


Allows you to set: 
e Confirmation defaults when 
you modify files 
e File attributes 


e Notification if extended 
attributes are lost 





Allows you to permanently remove 
deleted files from the system. 


Allows you to retrieve deleted files 
that have not been purged. 


attribute...] 


[/option...] [/? | /V 


Available options 


Manage according to search pattern 
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Parameter Use to 


(no parameter) If you type FLAG with no parameters, the attribute status of all the files in 
the current directory appears. 


path Specify the path to the file or directory whose attributes or search modes 
you want to modify. 


+|- Add attributes to a file or directory with the + (plus). 
Remove attributes from a file or directory with the - (minus). 


If neither + nor - is used, the attributes will be assigned to the file/ 
directory as specified. 


If you add and remove attributes in the same command, group all + 
(plus) attributes together and all - (minus) attributes together. 


attribute Specify one or more file or directory attributes. 


See “Directory Attributes” on page 61 and “File Attributes” on page 61. 


loption Replace option with any available option. See “General FLAG Options” 
on page 60. 

1? View online help. All other parameters are ignored when /? is used. 

IVER View the version number of the utility and the list of files it uses to 


execute. All other parameters are ignored when /VER is used. 





NOTE: For help with tasks, press F1 in the utility. 





Using FLAG 


+ Use FLAG options to add or delete directory and file attributes, as defined in the preceding 
parameters table. 


For attributes that can be applied to directories, see “Directory Attributes” on page 61. 


For attributes that can be applied to files, see “File Attributes” on page 61. 
+ When you add or delete multiple attributes, include a space between attribute abbreviations. 


+ You can use wildcard characters. 


General FLAG Options 


Option Use to 


/NAME | GROUP = name Change the owner of a file or directory. 


/D View details about a file or directory. 

/DO View or modify only directories in the specified path. 
IFO View or modify only files in the specified path. 
/OWNER=name View all files or directories owned by a user. 
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Option 


/M=mode 


IS 


IC 


Directory Attributes 


Option 


ALL 


Di (Delete Inhibit) 


Dm (Don't Migrate) 


H (Hidden) 


Ic (Immediate Compress) 


N (Normal) 
P (Purge) 
Ri (Rename Inhibit) 


Sy (System) 


File Attributes 


Option 


ALL 


A (Archive needed) 
Ci (Copy Inhibit) 


Dc (Do not Compress) 


Use to 


Modify search modes of executable files. See “Search Modes for 
Executable Files” on page 62. 


Search the subdirectory in the specified path and any subdirectories 
below that level. 


Scroll continuously through output. 


Use to 


Specify the Di, H, Ic, P, Ri, and Sy attributes as a group. Primarily used to 
assign directories these specific attributes. 


Prevent the directory from being deleted. 


This attribute overrides the trustee Erase right. When it is enabled, no 
one, including the owner and network administrator, can deletet the 
directory or file. A trustee with the Modify right must disable this right to 
allow the directory or file to be deleted. 


Prevent the directory from being migrated to a secondary backup system 
(regardless of what the volume is set to). 


Prevent the directory from being seen in the directory listing. 
Compress the files in the specified directory as soon as the OS can. 


This does not apply to the directory's subdirectories and the files in them. 
Use Ic in combination with the /S option to apply immediate compression 
to the directory's subdirectories and their files recursively. 


Specify no attributes. 
Purge the directory or files in a directory immediately when deleted. 
Prevent the directory from being renamed. 


System hides the directory so it does not appear in a file manager or 
directory listing. System is normally used with operating system files, 
such as Linux or NetWare system files. 


Use to 


Specify the A, Ci, Di, H, Ic, P, Ri, Ro, Sh, Sy and T attributes as a group. 
Primarily used to assign files these specific attributes. 


Indicate that the file has been modified since the last backup. 


Prevent files from being copied. This attribute overrides the trustee Read 
right and File Scan right. 


Prevent a file from being compressed. 
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Option 


Di (Delete Inhibit) 


Dm (Don't Migrate) 


Ds (Don't Suballocate) 


H (Hidden) 


Ic (Immediate compress) 
N (Normal) 

P (Purge) 

Ri (Rename Inhibit) 

Ro (Read Only) 


Rw (Read Write) 
Sh (Shareable) 


Sy (System) 


T (Transactional) 


X (Execute) 


Use to 


Prevent a file from being deleted or copied over. 


This attribute overrides the trustee Erase right. When it is enabled, no 
one, including the owner and network administrator, can deletet the 
directory or file. A trustee with the Modify right must disable this right to 
allow the directory or file to be deleted. 


Prevent a file from being migrated to a secondary backup system 
(regardless of what the volume or directory is set to). 


Prevent an individual file from being suballocated, even if suballocation 
is enabled for the system. Use on files which are enlarged or appended 
to frequently, such as certain database files. 


This flag applies only to files in a NetWare Traditional File System 
volume. 


Prevent a filename from being displayed with the DOS DIR command. 
The file can't be copied or deleted. 


Compress a file as soon as the OS can. 
Specify the Rw attribute. 

Purge a file immediately if the file is deleted. 
Prevent a file from being renamed. 


Allow a file to only be read; it can't be written to or deleted (in other 
words, Ro includes Ri and Di). 


Allow a file to be read and written to. 


Allow a file to be used by several users simultaneously. This attribute is 
usually used with Read Only. 


System hides the directory or file so it does not appear in a file manager 
or directory listing. System is normally used with operating system files, 
such as Linux or NetWare system files. 


Protect a file by using the Transaction Tracking System™. 


Identifies executable files such as .exe and .com files. 


Search Modes for Executable Files 





IMPORTANT: The syntax is /M=mode. Replace mode with a mode number from the following 





table. 

Mode Use to 

0 Search for instructions in the net . cfg file (the default mode). 

1 Search the path specified in the file. If there is no path, the file searches 
the default directory, and then all search drives. 

2 Search the path specified in the file. If there is no path, the file searches 
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only the default directory. 


Mode 


Status Flags 


Use to 


Search the path specified in the file. If there is no path, the file searches 
the default directory; then if the open request is read only, the file 
searches the search drives. 


Reserved; don't use. 


First search the path specified and then all search drives. If there is no 
path, the file searches the default directory and then all search drives. 


Reserved; don't use. 


First search the path specified. If the open request is read only, the file 
searches the search drives. If there is no path, the file searches the 
default directory and then all search drives. 





NOTE: Status flags show attribute information for a file or directory. You can't change these flags. 





Status 


Cc (Cannot compress) 


Co (Compressed) 


M (Migrated) 


Examples 


Indicates 


The file cannot be compressed because of limited space savings or 
failures that might have occurred during an unsuccessful compression 
attempt. 


If this flag is set for a file, the system will not attempt compression again 
until the next time the file is saved. To allow the file to be reevaluated for 
compression, use the COMPFIX utility to reset (turn off) this flag. For 
information, see Section 1.32, “COMPFIX,” on page 32. 


The file has been compressed. 


The file has been migrated. 


¢ To add Rw and Ic and remove Di and A from all files in the current directory, enter 


FLAG *.* +R W lc -Di A 


+ To view attributes for file STUDENTS in directory sys: \course\winter, enter 


FLAG SYS:\COURS 








E\WINTER\STUDENTS 











¢ To give files in drive G: the Hidden attribute, enter 


FLAG G:*.* H /FO 


¢ To set the search mode to 7 for all executable files in the current directory, enter 
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FLAG *.* /M=7 


+ To set the search mode to 1 and assign all files in the current directory the Read Write attribute, 
enter 


FLAG *.* RW /M=1 


1.57 Format 


Purpose 


Use at the System Console prompt to format a local FAT volume, such as diskettes or USB drives, 
that have not already been formatted. 


Syntax 


FORMAT Local FAT Vol [/V:label] [/U] [/Q] [/FS:fat_type] 
[/A:cluster size] 


Parameter Use to 


Local_FAT_Vol Specify a drive letter followed by a colon. 


N: label Specify a label for the newly formatted FAT volume. Quotes are allowed in the label 
name. 

/U: label Unconditionally format the whole drive. 

IQ Perform a quick format of the device. Resets only the boot sector, FAT, and 


directory, and is the default format. 
IFS: fat_type Specify the filesystem type, FAT or FAT32. 


/A: cluster_size Specify the required size for a cluster. Options include 512, 1K, 2K, 4K, 8K, 16K, 
32K, 64K, 128K, 256K, 512K. 





IMPORTANT: The format fails if the requested size is not possible. 





Examples 


To format a diskette that is located in drive A: of the server and label the volume with the name of 
DEMO, enter the following at the system console promt: 


FORMAT A: /V: DEMO 





To quickly format a diskette that is located in the A: drive of the server, enter the following at the 
System Console prompt: 
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FORMAT A: /Q 


1.58 Health 


Purpose 


Use at the server console to display the status of a server's overall health on the system console as 
determined through Novell Remote Manager. 


Syntax 


health [all] 


Parameter Use to 
no parameter, default Display only the overall server health status. 
all Display the status for all individual components that 


comprise the server’s overall health. 


The asterisk (*) indicates the lowest value for the 
component rather than the peak. 


The output on the System Console screen from the 
health all command might not display correctly 
on non-English language servers. Use Novell 
Remote Manager from a client browser to view the 
Server Health summary listing. 


Using Health 


To use this command, make sure portal.nim is loaded on the server. 


If the overall health status for the server is any value other than Good, you might want to view the 
status of the individual components by using the All option. By default, all components are included 
in this status. If you want to exclude any component, configure the Include options by using Novell 
Remote Manager. 


Health Status Definitions 


Status Meaning 

Good The status of all components included in the server's health configuration 
list is Good. 

Suspect One or more of the components included in the server's health 


configuration list has a Suspect status or has a minor problem. 


Bad One or more of the components included in the server's health 
configuration list has a Bad status or has a critical problem. 
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Additional Information 


Topic See 


Excluding a component from overall server health “Monitoring Overall Server Health or the Health of a 
in Novell Remote Manager Specific Item” in the NW 6.5 SP8: Novell Remote 
Manager Administration Guide. 


1.59 HELP 


Purpose 


Use at the server console to view the syntax, a brief description, and an example of a console 
command. 


Syntax 


HELP [console command] [ALL] 





Parameter Use to 

(no parameter) View a list of all console commands. 

console command Specify the name of the console command you want to view help for. 
ALL View a short description of each console command. 


Press Enter after each description to view the next description. Press 
Esc to exit. 


Examples 


+ To view help for LIST DEVICES, type 








fa] 





ELP LIST DEVICES 











+ To view a description of each command, type 


an 


ELP ALL 
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1.60 Hidescreen 


Purpose 


Use this command at the System Console prompt to hide a screen for a utility that is running at the 
server console. Using this command can be helpful if there is a console utility that you want to run 
but you don't always want to view its screen while it is running. 


To learn a screen name, press Ctrl+Esc to display the Current Screens list. Hidden screens are 
indicated by an asterisk before the screen name in this list. 


To restore a screen after it has been hidden, use the Showscreen (page 252) command. 


Syntax 














HIDESCREEN screen name 





Examples 


To hide the running Monitor screen, enter 














HIDESCREEN netware 6 console monitor 





1.61 ICAPTURE 


Purpose 


ICAPTURE is a DOS command line utility that lets you capture LPT ports and redirect the output to 
iPrint printers. The utility is installed when you install the iPrint Client, and it can be used at the 
DOS-box command line, called from a batch files, or called from a login script. 





IMPORTANT: Icapture.exe requires that the ¡Print printer be installed before the command is 
run. You can install a printer from the DOS command line using IPRNTCMD (page 75). 





Use the following parameters when executing the icapture.exe command. 


Parameter Description 


LPTx or L=x where x is the Port you want to capture. 
port number 


P=printer_name Name of the printer that appears in the Printers Folder after the iPrint 
printer is installed. 


EndCap Ends the capture to the specified port. 





NOTE: Captured ports remain captured, even through a workstation 
restart, until you end the capture. 
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Parameter Description 


Show Displays status of currently captured ports and their associated printers. 


Syntax 





icapture 1=LPT port number p=iPrint printer name[parameters] 


Additional Information 


Topic See 


Using ICAPTURE “Using Icapture.exe to Capture Printer Ports” in the NW 6.5 SP8: ¡Print 
Administration Guide 


1.62 ICE 


Purpose 
The Novell Import Conversion Export (ICE) utility lets you 


¢ Import data from LDIF files to an LDAP directory. 

+ Export data from the LDAP directory to an LDIF file. 
+ Migrate data between LDAP servers. 

+ Perform a schema compare and update. 


¢ Load information into eDirectory using a template. 
Syntax 
ice general options 


-S[LDIF | LDAP | DELIM | LOAD | SCH] source_options 
-D[LDIF | LDAP | DELIM] destination_options 


























For a description of the options, see “Novell eDirectory Linux and UNIX Commands and Usage” in 
the Novell eDirectory 8.8 Administration Guide. 


Additional Information 


Topic See 


Novell Import Conversion Export Utility Novell eDirectory 8.8 Administration Guide 
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1.63 IFCONFIG 


Purpose 


Use at the server console to configure network interface parameters. 

Syntax 

ifconfig board_name create addr address [parameters].. 

Binds address as a primary IP address to the board board_name with the specified parameters. Note 


that a board cannot have more than one primary IP address in a given network. 


ifconfig board_name AddrChange address new_address [parameters]... 





Changes a primary IP address of the board board_name from address to new_address. 


ifconfig board_name [addr address] [parameters]... 


Configures specified parameters. Use the optional [addr address] if the board board_name has 
multiple primary IP addresses bound to it. Ifconfig board_name displays the board parameters. 


ifconfig board_name [addr address] destroy [verbose] 


Unbinds the primary IP address bound to the board board_name. Use the optional [addr address] if 
the board board_name has multiple primary IP addresses bound to it. 


ifconfig [-a] [-d | -u] [-af address family] 


Displays the parameters of all the boards: 

-a displays information about all the boards in the system. 
-d displays the parameters of boards that are down. 

-u displays the parameters of boards that are up. 


-af specifies the address family. The supported address family is inet. 


ifconfig -1 [-d | -u] [-af Address Family] 
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Displays the list of all the board names. 


ifconfig -help | -h 


-help displays the detailed help for the utility. 


-h displays the syntax of the utility. 


Parameters 


add | alias sec_ip_address 


noarp 


delete | -alias sec_ip_address 


metric | Cost cost 
Mcast ¡p_address 


-Mcast 


down 


up 


Netmask | Mask mask 
ProxyARP 

- ProxyARP 

DefRoute 

-DefRoute 

PoisonReverse 
-PoisonReverse 

Gateway | Gate ip_address 
arp 

-arp 


broadcast | Bcast 
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Use To 


Add the specified sec_ip_address as a secondary IP address to 
the specified board. 


Specify a secondary IP address as non-arpable. 
Delete the secondary IP address. 

Specify the cost that RIP associates with this interface. 
Override TCP/IP’s standard IP multicast handling. 


Send IP multicast packets using TCP/IP standard practices. This 
is the default Mcast option. 


Mark an interface so that the system will not attempt to transmit 
messages through that interface. 


Enable an interface after an "ifconfig down". It happens 
automatically when setting the first address on an interface. If 
the interface was reset when previously marked down, the 
hardware will be reinitialized. 


Specify the mask of an interface. 

Enable the Proxy ARP option. 

Disable the Proxy ARP option (default). 
Enable the default route option. 

Disable the default route option (default). 
Specify that RIP uses Poison Reverse. 
Disable the poison reverse option (default). 
Specify the gateway for this interface. 
Enable the use of ARP (default). 

Disable the use of ARP. 

Specify the broadcast IP address. 
Default: FF.FF.FF.FF 


1.64 iMonitor 


Purpose 


Novell iMonitor provides cross-platform monitoring and diagnostic capability to all servers in your 
eDirectory tree. This utility lets you monitor your servers from any location on your network where 
a Web browser is available. iMonitor lets you look at the eDirectory environment in depth on a 
partition, replica, or server basis. You can also examine what tasks are taking place, when they are 
happening, what their results are, and how long they are taking. 

Syntax 


(In a Web browser) 


http://server's TCPIP address:httpstack port/nds 


Additional Information 


Topic See 

Using Novell ¡Monitor Novell eDirectory 8.8 Administration Guide 
1.65 INETCFG 

Purpose 


Use at the server console to set up and customize your internetworking configuration for IPX, IP, 
and AppleTalk*. 


INETCFG simplifies the process of configuring local area networks (LANs) to work with network 
and routing protocols supported by NetWare®. 


Syntax 


[LOAD] INETCFG 





Using INETCFG 


When you load INETCFG, the Internetworking Configuration menu appears, as shown in the 
following figure. You access INETCFG features from this menu. 
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Figure 1-2 Description: Description: Internetworking Configuration menu 





Internetuorking Configuration 


Boards 
Netuork Interfaces 
WAN Call Directory 


Protocols 
Bind ings 


General Node Information 





Menu options are described in the following table. 


Option 


Boards 


Network Interfaces 


WAN Call Directory 


Protocols 


Bindings 


Manage Configuration 


View Configuration 
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Use to 


Select and configure boards. To configure a board, you select a driver, 
assign a name to the board, and specify values for the board 
parameters. 


Each driver that is compatible with NetWare has a driver description file, 
sometimes called the LDI file. The LDI file defines the parameters 
necessary for the driver to operate with the board you select. It also 
specifies the valid range of values for each parameter. 


If a driver has an LDI file, the parameters are presented in the Board 
Configuration window; you simply select a value for each parameter. 


If a driver has no LDI file, you must enter the values yourself in the Board 
Parameters field. 


Applies only to wide area network (WAN) configurations for multiple 
interface WAN boards. (NetWare does not support WANs.) 


Applies only to WAN configurations. (NetWare does not support WANs.) 


Select and configure network protocols. To configure a protocol, you 
select the protocol, such as IPX or IP, and configure the protocol-specific 
parameters that pertain to routing, packet forwarding, etc. 


+ Bind a network protocol to an interface. 


+ Configure protocol and interface-specific parameters, such as 
frame type, network number (for IPX), local IP address (for IP), and 
zone information (for AppleTalk). 


+ Delete a bound interface from the configuration. 
Specify Simple Network Management Protocol (SNMP) information, 


such as the SNMP device name, hardware description, physical location, 
and human contact for the server or router. 


+ View the INETCFG configuration information file and the console 
messages captured during system initialization 


+ Import or export configuration information to or from a diskette. 


INETCFG records information in various configuration (. cfg) files located in sys: \etc. Some of 
these files are present at system startup; others are created by INETCFG, depending on what you 
configure. Here is a partial list of these files: 

* aurp2 

+ tcpip.cfg 

+ ipxspx.cfg 

* nlsp.cfg 


* netinfo.cfg 





WARNING: INETCFG creates these files strictly for its own use; do not delete them or change 
their contents. 





Additional Information 


Topic See 


Capturing console messages Section 1.34, “CONLOG,” on page 35 


1.66 INITIALIZE SYSTEM 


Purpose 


Use at the server console to enable the multiprotocol router configuration by executing all 
commands in the system netinfo.cfg file. 


Syntax 





INITIALIZE SYSTEM 











Using INITIALIZE SYSTEM 


This command is typically executed from the initsys.ncf file during server startup. 





WARNING: Executing INITIALIZE SYSTEM on a system that has already been initialized can 
generate errors when the system discovers that the commands in the net info.cfg file have already 
been executed. 





Additional Information 


Topic See 


Server startup Section 1.153, “Server,” on page 186 
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1.67 iPrint Broker 


Purpose 


The Broker provides three network support services not previously available in NetWare: the 
Service Registry Service (SRS), Event Notification Service (ENS), and Resource Management 
Service (RMS). While these services are invisible to end users, administrators should be aware of 
them. Novell Distributed Print Services™ (NDPS®) uses these services in the following ways: 


+ Service Registry Service. The Service Registry allows public access printers to advertise 
themselves so that administrators and users can find them. This service maintains information 
about device type, device name, device address, and device-specific information such as the 
manufacturer and model number. 


+ Event Notification Service. This service enables printers to send customized notifications to 
users and operators about printer events and print job status. The Notification Service supports 
a variety of delivery methods including NetWare pop-up, log file, e-mail (GroupWise®), and 
programmatic. 


+ Resource Management Service. This service allows resources to be installed in a central 
location and then downloaded to clients, printers, or any other entity on the network that needs 
them. The Resource Management Service supports adding, listing, and replacing resources 
including printer drivers, printer definition (PDF) files, banners, and fonts. 


Additional Information 


Topic See 
Creating a Broker “Creating a Broker” in the NW 6.5 SP8: ¡Print Administration Guide 
Managing the Broker “Managing the Broker” in the NW 6.5 SP8: ¡Print Administration Guide 


1.68 ¡Print Print Manager 


Purpose 


The Print Manager is an object in the eDirectory™ tree as well as software that runs on your server. 
Print jobs are submitted to the Print Manager and then forwarded to the printer, when the printer is 
ready. 


A single Print Manager can handle print jobs for multiple printers. Depending on your network 
configuration (for example, remote locations), you can create additional Print Managers on other 
servers, but only one Print Manager can exist on the any one server. Using access control, the Print 
Manager allows authorized users to print. 


A single Print Manager can control multiple Printer Agents. (There is no hard limit.) 


A specific Print Manager can be loaded only on one server. If it controls a local printer, it must be 
loaded on the server that the local printer is attached to. 


A user creating an Print Manager should have the Supervisor right for the container where the object 
will be created. 
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1.69 IPRNTCMD 


Purpose 


If you need to install an iPrint printer but cannot use a Web browser, you can use the IPRNTCMD 
command at a DOS prompt. Iprntcmd.exe can install, remove, or set a printer as the default 
printer. This command is most often used in login scripts in conjunction with the ICAPTURE 
(page 67) command. Use the following parameters when executing the IPRNTCMD command. 


Parameter Description 

add Installs the specified printer. 

default Sets the specified printer as the default. 

remove Removes the specified printer. 

temporary Installs the specified printer for this session only. When the workstation is 


rebooted, the printer is removed. 


Syntax 


iprintcmd iprint printer url [parameters] 


Additional Information 


Topic See 


Using IPRNTCMD “Using iprntemd on Linux and Macintosh” in the NW 6.5 SP8: ¡Print 
Administration Guide 


1.70 IPXCON 


Purpose 
Use at the server console to 


+ Monitor and troubleshoot IPX routers and network segments throughout your IPX internetwork 
+ View the status of an IPX router or network segment 

¢ View all paths through which IPX packets can flow 

+ Locate all active IPX routers on your internetwork 


+ Monitor remote IPX routers that are running NetWare® IPX Router software 
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Syntax 


[LOAD] IPXCON [/P] 


Parameter Use to 

/P View the Link State Packets (LSPs) received by the router, if the remote 
router is running NetWare Link Services Protocol™ (NLSP™). 

Using IPXCON 


When you load IPXCON, the top of the screen displays a summary of routing statistics for the 
selected router. (The following figure shows a partial display of routing statistics.) The bottom of the 
screen displays an Available Options menu. 


Figure 1-3 IPXCON Routing Statistics Screen Example 





IPX Console 3.00 







Host Address: RT311-DNL 


Packets Received: 61234 
Packets Sent: 144514 
Packets Forwarded: 0 


The following table explains the fields in the summary display. Because IPXCON is a real-time 
monitor, these fields are always active, and some values in the fields change as the router processes 


IPX packets. 

Field Explanation 

Host Address Name of the router being monitored. 

Packets Received Number of IPX packets received by the selected router. 

Packets Sent Number of IPX packets sent by the selected router. 

Packets Forwarded Number of IPX packets forwarded by the selected router. 

Circuits Number of circuits in use on the router. 
A circuit is a logical attachment to a network segment through which a 
router can reach other systems. A circuit can be a local or wide area 
connection. 

Networks Number of networks known to the selected router. 

Services Number of services that can be reached from the selected router. 
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The Available Options menu allows access to additional features of IPXCON. These features are 
described in the following table. 


Option 


SNMP Access Configuration 


IPX Information 


IPX Router Information 


NLSP Information 


Circuits 
Forwarding 


Services 


Use to 


Select the server you want to monitor. 


You can monitor the local system, which is the default, or a remote 
system. 


You can monitor the remote system through IPX or TCP/IP. 


You can also set the poll interval to specify how often the information will 
be retrieved through SNMP. 


View statistics for the selected router's IPX packet routing. 


To display additional packet routing statistics, select Detailed IPX 
Information from the bottom of the IPX Information window. 


View general information about the selected IPX router. 
View the following NLSP information about the selected router: 
System information Area addresses Neighbors Routers LANs LSPs 


To view the Link State Packets (LSPs) received by the system, load 
IPXCON by typing 


[LOAD] IPXCON /P 

The LSP option is enabled only if the server is running NLSP. 
View circuit information. 

View the Forwarding table. 


View information for the currently reachable services. 


+ IPXCON uses Simple Network Management Protocol (SNMP) to exchange management 
information and operational statistics with remote IPX routers. 


+ IPXCON operates over both IPX and TCP/IP networks. 


¢ To execute IPXCON automatically each time you boot the server, add the Load IPXCON 
command after the initsys.ncf line in your autoexec.ncf file. 


1.71 IPXPING 


Purpose 


Use at the server console to check connectivity to an IPX server on your internetwork. 


Syntax 


[LOAD] IPXPING 
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Using IPXPING 


+ IPXPING sends an IPX ping request packet to an IPX target node (server or workstation). 
When the target node receives the request packet, it sends back a reply packet. 


+ To select an IPX server or workstation, enter its IPX internal network number and node 
number. 


You can also specify the number of seconds between each request packet transmission. 


¢ To start sending request packets, press Esc. The sending node continues to send request packets 
and collect response time statistics until you press Esc again to exit IPXPING. 


+ Request and reply packets use the same format; each packet contains the standard IPX header. 


+ To add other nodes, press Insert and select another server. 


1.72 IPXS 


Purpose 


Provides IPX protocol to NLM™ programs that require STREAMS-based IPX. 


Syntax 


[LOAD] [path]IPXS [LDFILE = [path] filename[.ext]] 





Parameter Use to 
path Specify the path to ipxs.n1m if you moved it from the default directory. 


LDFILE = [path]\filename[.exf] (Optional) Specify a filename that contains the SAP filtering, SAP and 
RIP timers, and IPX configuration parameters. 


Note: If you don't specify a filename, IPXS sets the parameters defined 
in the ipxspx.cfg file. 


If you don't specify a file extension, the default is . cfg. 
For example, to load an alternate configuration file, type 


[load] ipxs Idfile = ipxspx2.cfg 


Using IPXS 





NOTE: The ipxspx.cfg file is modified from the INETCFG utility when you set SPX/IPX 
parameters. 


+ When you load ipxs, streams is autoloaded. 


¢ Ipxspx.cfg contains the Service Advertising Protocol (SAP) filtering, SAP and Router 
Information Protocol (RIP) timers, and the IPX configuration defaults. 


+ You can create multiple configuration files in addition to ipxspx.cfg. Use this feature if you 
frequently alternate between two or more IPX/SPX configurations. 
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To create multiple configuration files, copy the ipxspx.cfg file to a new filename 
(ipxspx.cfg, for example). Then you can change the ipxspx.cfg file (by using INETCFG) 
and still preserve the original configuration in the ipxspx2.cfg file. 


¢ To load a configuration file other than the default ipxspx.cfg file, use the LDFILE option. 


For example, if you have a second configuration file called ipxspx2.cfg, you can load that 
configuration by typing 


[LOAD] IPXS LDFILE = IPXSPX2 





Additional Information 


Topic See 

Filtering RIP and SAP packets using SET Section 1.154, “SET,” on page 188 
Setting IPX parameters using SET Section 1.154, “SET,” on page 188 
Setting IPX parameters using INETCFG Section 1.65, “INETCFG,” on page 71 
Purpose 


Load at the server console to start the Novell® JVM for NetWare® product. The Novell JVM 
product is comprised of several NLM™ programs that let the NetWare server run Java*-based 
applications and applets, including multi-threaded applications and applications that use a graphical 
interface. 


Syntax 


[LOAD] JAVA 


Using JAVA 


+ You must load the JVM before you can run Java-based applications and applets on the server 
and before you can set necessary environment variables. 


¢ Starting the NetWare servertop automatically loads the JVM. 


Additional Information 


Topic See 
General information about NetWare Java-based “Java-Based Components of NetWare” in the 
components NW 6.5 SP8: Server Operating 


SystemAdministration Guide 
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Topic See 
Using Java on the NetWare Server “Using the Novell JVM (NJVM) for NetWare on 
the Server”Using the Novell JVM (NJVM) for 


NetWare on the Server” in the NW 6.5 SP8: 
Server Operating SystemAdministration Guide 


1.74 KEYB 


Purpose 
Use at the server console to change the console keyboard type to the language of your keyboard. 


The language you specify with KEYB must match the language of your keyboard, not the server 
language. 





IMPORTANT: Changing the keyboard type causes some keys to represent different characters. 
Therefore, do not use this command unless you have the appropriate keyboard for the language you 
are specifying and you are familiar with the keyboard's use. 





Syntax 





[LOAD] [path]KEYB [keyboard typel 


Parameter Use to 
(no parameter) View a list of available keyboard types. 
path Specify the path to ke yb. n1m if you moved it from the default directory. 
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Parameter Use to 
keyboard_type Specify one of the following keyboard types: 


Belgium 

Brazil 

Canadian French 
Denmark 

France 

Germany 

Italy 

Japan 

Latin America 
Netherlands 
Norway 

Portugal 

Russia 

Spain 

Sweden 

Swiss French 
Swiss German 
United Kingdom 
United States 
U.S. International 


Using KEYB 


To change the keyboard type, unload KEYB and then reload it, specifying the new keyboard type 
parameter. 


1.75 KF8 


Purpose 


Use at the server console to enable or disables pausing between commands executed from NCF files. 


Syntax 


KF8 parameter 


Parameter Use to 
On Enable pausing between commands. 
Off Disable pausing between commands. 
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1.76 LANGUAGE 


Purpose 


Use at the server console to set the language for subsequently loaded modules. 


NOTE: LANGUAGE does not change the language of the operating system or of currently loaded 


modules. 





The LANGUAGE command gives the modules access to directories containing message files in the 
specified language. This directory structure is under sys:systemas follows: 


sys:systeminlsVanguage number 


Syntax 








LANGUAGE [language name | number] [LIST | REN number new_name] 


Parameter 


(no parameter) 


Use to 


View the current language setting for modules. 


language_name | number Specify a language by its name or number. 


LIST 


Display a list of language names and numbers. (Not all languages in the 
list are supported.) 


REN number new_name Rename a language specified by a language number. The syntax is: 


Examples 


LANGUAGE REN number new_name 


+ To set a module to use the German message files, type 





LANGUAGE 














or 


LANGUAGE 7 





+ To change the name of Spanish to Espanol, type 





LANGUAGE 





REN 14 ESPANOL 














¢ To display a list of language names and numbers, type 


LANGUAGI 
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E LIST 


Reference 


1.77 LFVMOUNT 


Purpose 


Use at the System Console prompt to mount all local FAT volumes not recognized by DOS and 
assign them a local drive letter. 


Syntax 


LFVMOUNT 


1.78 LFVOLUMES 


Purpose 


Use at the System Console prompt to display a list of local FAT volumes currently mounted. 


Syntax 


LFVOLUMES 





1.79 LIST DEVICES 


Purpose 


Use at the server console to display a list of the storage devices on the server and to register new 
devices with the server's Media Manager database. 


A device can be a disk drive, magneto-optical disc drive, CD-ROM, or any other physical device. 


Syntax 





LIST DEVICES 











Using LIST DEVICES 


LIST DEVICES forces a scan for devices , displays the return list of storage devices, and registers 
any new devices with the Media Manager database. This command does not simply read the 
database. 


When you are installing new storage devices, you can load drivers with a no scan parameter, and 
then run LIST DEVICES so that drivers will find their devices simultaneously. 
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The command output is returned by the device drivers. The information for each storage device 
includes the device number and name, as well as additional information that varies by device and by 
manufacturer. 


Following is an example of a device listing: 





0x0001: [VO23-A0-D0:0] SEAGATE ST31051N rev:0530 
0x0002: [VO23-A0-D0:1] NEC CD-ROM DRIVE:500 rev:2.5 














The hexadecimal integer at the beginning of the line is the device's Media Manager object ID. 
The bracketed numbers comprise the device name that identifies the storage device, as follows: 


+ Vendor number. A unique number specific to the device vendor 


+ Adapter number. The instance number of an adapter registered with Media Manager. In the 
example, AO identifies the first instance of an adapter installed in the server. 


+ Device number. The number of the disk or other device. For a SCSI disk, this is the SCSI ID, 
usually set by a jumper on the hard disk. 


For an IDE disk, this number represents the bus from the IDE controller. IDE numbers range 
from DO through D3, representing the primary, secondary, tertiary, or quaternary bus. 


¢ Logical unit number (LUN). The LUN identifies individual devices when more than one 
device is attached to one bus. 


For example, one IDE bus can be attached to two disks, a master and a slave. LUN 0 represents 
the master and LUN 1 represents the slave. 


However, because disk manufacturers rarely use the logical unit number to identify hard disks, 
the LUN almost always appears as 0. 


The driver's version or revision number appears at the end of the line. 


Additional Information 


Topic See 


Reading the Media Manager database and displaying Section 1.80, “LIST STORAGE ADAPTERS,” on 
a list of registered storage devices and controllers page 85 


Scanning for new SCSI devices and registering them Section 1.149, “SCAN FOR NEW DEVICES,” 


with the Media Manager on page 181 

Scanning for all SCSI devices or a specified SCSI Section 1.148, “SCAN ALL,” on page 179 
device and registering new devices with the Media 

Manager 


Determining the operating status of a storage device “Activating and Deactivating a Hard Disk” in the 
NW6.5 SP8: Server Disks and Storage Devices. 


Storage device drivers “Drivers for Host Adapters and Storage Devices” 
in the NW6.5 SP8: Server Disks and Storage 
Devices 
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1.80 LIST STORAGE ADAPTERS 


Purpose 


Use at the server console prompt to display a list of registered storage adapters and the devices they 
drive. The information is read from the Media Manager database. 


Syntax 





LIST STORAGE ADAPTERS 











Examples 


Following is an example of a listing of a server's storage adapter and the associated storage device: 





[VO25-A0] NOVELL IDE HOST ADAPTER MODULE 
[VO25-A0-D1: 0] QUANTUM FIREBALL TM3840a 


























The first line in the example identifies an IDE disk adapter. The second line identifies a hard disk 
operated by that adapter. The second line is indented to indicate that the device is associated with the 
adapter in the preceding line. 


The bracketed numbers at the beginning of each line comprise the device name. The device name 
identifies the adapter or device, as follows: 
+ Vendor number. A unique number specific to the device vendor. 


+ Adapter number. The instance number of an adapter registered with NWPA. In the example, 
AO identifies the first instance of an adapter installed in the server. 


+ Device number. The number of the disk or other device. For a SCSI disk, this is the SCSI ID, 
usually set by a jumper on the hard disk. 


For an IDE disk, this number represents the bus from the IDE controller. IDE numbers range 
from DO through D3, representing the primary, secondary, tertiary, or quaternary bus. 


¢ Logical unit number (LUN). The LUN identifies individual devices when more than one 
device is attached to one bus. 


For example, one IDE bus can be attached to two disks, a master and a slave. LUN 0 represents 
the master and LUN | represents the slave. 


However, because disk manufacturers rarely use the logical unit number to identify hard disks, 
the LUN almost always appears as 0. 


Additional Information 


Topic See 


Scanning devices and registering new devices with Section 1.79, “LIST DEVICES,” on page 83 
Media Manager 
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Topic 


Scanning for new SCSI devices and registering them 
with the Media Manager 


Scanning for all SCSI devices or a specified SCSI 
device and registering new devices with the Media 
Manager 


Determining the operating status of a storage device 


Storage device drivers 


See 


Section 1.149, “SCAN FOR NEW DEVICES,” 
on page 181 


Section 1.148, “SCAN ALL,” on page 179 


“Activating and Deactivating a Hard Disk” in the 
NW6.5 SP8: Server Disks and Storage Devices 


“Drivers for Host Adapters and Storage Devices” 
in the NW6.5 SP8: Server Disks and Storage 
Devices 


1.81 LIST STORAGE DEVICE BINDINGS 


Purpose 


Use at the server console to list all Custom Device Modules (CDMs) bound to a particular device. 


Syntax 





LIST STORAGE DEVICE BINDINGS number 














Parameter Use to 


number Specify the object number for the device whose CDMs you want to list. 


To find the object number, enter LIST DEVICES at the console prompt. 
The object number is the first number on the left. 


This number is displayed with leading zeros, for example, 0x0001. Do not 
include the zeros on the command line; for example: 


list storage device bindings 1 


Using LIST STORAGE DEVICE BINDINGS 


When you execute the command, the screen displays information similar to the following: 





Device: [V312-A0-D0:0] SEAGATE ST32430N rev:0510 








Filter: NetWare Elevator Filter 
Filter: NetWare Sector Conversion Filter 
Base: Novell SCSI Fixed Disk CDM 














HAM: [V312-A0] ADAPTEC PCI Host Adapter Module 





The first line specifies the device. 
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The next lines specify the CDMs associated with the device. 


¢ Filters are CDMs that communicate with the storage device. The elevator filter controls 
messages to and from the storage device, including scatter-gather messages. The sector 
conversion filter converts sector sizes to standard 512 byte units. 


+ The Base is the essential CDM required to manage communication with the Host Adapter 
Module. 


¢ Information about CDMs for changers (called Enhancers) might also be displayed. 


The last line identifies the Host Adapter Module for the adapter to which the device is connected. 


1.82 LOAD 


Purpose 


Use LOAD to link loadable modules to the operating system. Loadable modules include disk 
drivers, LAN drivers, NLM™ programs, platform support modules, and name space modules. 


Use the LOAD command to load application modules to a protected address space, a region of 
logical memory in user mode (ring 3). Protected modules operate in their own execution 
environment. You can also mark a protected address space for restart after cleanup. 





IMPORTANT: LAN and disk drivers or the MONITOR utility are not candidates for protected 
address space because they must run in the kernel. For example, MONITOR makes system calls that 
the call gate doesn't allow between protected space and the kernel. 





Use the LOAD command at the server console to load server NLM programs. You can also use 
LOAD at a workstation running the Novell® Client™ to load client modules. Client NLM programs 
used by Novell Client load without parameters. 





TIP: In most cases you can load an NLM program by simply entering the name of the NLM 
program at the server console prompt. LOAD is implied. For example, to load monitor .nlm, just 
enter MONITOR. 


The exception is if there is an .ncf file of the same name as the utility. In this case, you must use 
the LOAD command. Using LOAD tells the server to load the utility instead of executing an .ncf 
file with the same name. 





The following information explains the loading process and load parameters, whether or not you 
actually use LOAD as part of the command string. 


Syntax 














[LOAD] [PROTECTED | RESTART | address space name] [path]loadable module name 
[parameter...] 
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Option Use to 


path Specify the path to the loadable module if you moved it from the default 


directory. 
loadable_module_name Specify the name of the loadable module. To determine the name, see 


the documentation for the loadable module. 


parameters Include parameters for the module you are loading. Parameters that can 
be used with most modules are explained in the following tables. 


Individual modules may have specific parameters of their own; see the 
documentation for the loadable module. 


Memory Protection Parameters 


Parameter Use to 


protected module_name Load one module into a new protected address space. By default the 
space is named ADDRESS_SPACEn, where n is a number. 


If you want to load more than one module into the same address space, 
use the address space parameter instead of the protected parameter. 


restart module_name Load one module into a new protected space with restart functionality. By 
default the space is named ADDRESS_SPACEn, where n is a number. 


Restart functionality means that if the protected space abends, the 
system closes the space, cleans up its resources, restarts the space, and 
reloads modules into it. 


address space = Load one module into a new protected address space with a user- 
address_space_name defined name. Use this command when you want to define your own 
module_name name for the space and when you want to load more than one module 


into the same address space. 


You can specify only one module at a time to load into the address 
space, but you can repeat the command for each module you want to 
load into the space. 


Using LOAD 


+ When a module is loaded, it links itself to the operating system and allocates a portion of the 
computer's memory for its use, thus using system resources. When modules are unloaded, 
allocated resources are returned to the system. 


Some modules, such as LAN drivers and disk drivers, need to be loaded every time the server is 
booted. To load modules automatically when the server boots, include LOAD commands in the 
autoexec.ncf or startup.ncf file. (See “Using Server Batch Files” in the NW 6.5 SP8: 
Server Operating SystemAdministration Guide.) 


Other modules, such as MONITOR, can be loaded, used, and then unloaded. Refer to the 
documentation for the specific module. 
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+ You can load modules in protected address space. Because NetWare supports NLM programs 
running in user mode (ring 3), server-based network applications, such as Group Wise® or 
Lotus* Notes* can have their own execution environment. 


+ You can also load shared libraries such as CLIB in more than one space (point one copy to two 
places). Multiple instances share code but have different data. Because each instance of the 
module must be loaded at the same logical address in each address space, that place is reserved 
across application spaces when you load the shared library in the first address space. 


+ When you install system and public files on the server, any .nim and .1an modules are copied 
to sys:system. The .ham and .nam modules are copied to the boot directory of the server. 


¢ The installation of LAN drivers can be best accomplished with HDETECT. This means that 
HDETECT can load, bind, and configure the drivers and add the LOAD command to the 
autoexec.ncf file. (See “Unbinding and Unloading LAN Drivers” in the NW 6.5 SP8: Novell 
Server Communications Administration Guide and Section 1.116, “NWCONFIG,” on 
page 146.) 


Examples 


¢ To load the NE3200™ driver (without parameters), enter 


[LOAD] NE3200 





+ To load the NWCONFIG module, enter 


[LOAD] NWCONFIG 


+ To load a module called database .nlm in a protected address space, enter 





[LOAD] PROTECTED DATABASE .NLM 














¢ To load a module in a protected address space and flag the address space as restartable, enter 








[LOAD] RESTART GRPWISE 


The PROTECTED option is not necessary if either RESTART or ADDRESS SPACE are 
specified on the command line. 


Additional Information 


Topic See 


Loading disk drivers “Loading Disk Drivers” in the NW6.5 SP8: Server Disks 
and Storage Devices 


Loading LAN drivers “Loading and Binding LAN Drivers” in the NW 6.5 SP8: 
Novell Server Communications Administration Guide 
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Loading name space modules “Storing Non-DOS Files on a Traditional Volume” in the 
NW6.5 SP8: Traditional File System Administration Guide 

Loading modules “Loading and Unloading NetWare Loadable Modules” in 
the NW 6.5 SP8: Server Operating SystemAdministration 
Guide 

Using protected address spaces “Loading Protected Address Spaces”, “Using Protected 


Address Spaces”and “Unloading Protected Address 
Spaces” in the NW 6.5 SP8: Server Memory 
Administration Guide 


1.83 Loggerpath 


Purpose 


Use at the System Console prompt to change the directory where the logger. txt file is saved. The 
default directory is the server startup directory. If the path does not exist, it is created. 


You can change the path to any volume on volume sys: or the boot drive. 


The logger.txt file contains the text from the logger screen buffer. 


Syntax 





loggerpath = volume_name:directory_ name 


For example: 


loggerpath = sys:\logger 


Additional Information 


For related information, see Section 1.84, “Loggersave,” on page 90. 


1.84 Loggersave 


Purpose 


Use at the System Console prompt to save the logger screen buffer to the logger. txt file. The 
default directory is the server startup directory. 


You can change the path it is saved to using the loggerpath command. 
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Syntax 


loggersave 


Additional Information 


For related information, see Section 1.83, “Loggerpath,” on page 90. 


1.85 LOGIN 


Purpose 


Use at a workstation to access the network by logging in to a server and running a login script. 








Syntax 

LOGIN [server _name/ | tree/][user] [/option...][/? | /VER] 

Parameter Use to 

(no parameter) Request a login prompt. 

server_namel Specify the server you want to log in to. 

treel Specify the tree you want to log in to. 

user Specify the username you want to log in with. 

/option Replace option with any available option. See “LOGIN Options” on 
page 92. 

1? View online help. All other parameters are ignored when /? is used. 

INNER View the version number of the utility and the list of files it usfes to 
execute. All other parameters are ignored when /VER is used. 

Using LOGIN 


+ Using LOGIN implies use of the LOGOUT command. That is, using LOGIN to access an 
additional server logs you out of all other servers. 


To remain logged in to other servers, use the no script (/NS) option. 





NOTE: Using the /NS option is similar to using the ATTACH command in NetWare® 3. 





+ To use another object's login script, you need the Read property right to the Login Script 
property of that object. This login script replaces the profile script (if one is specified). 


¢ To set your context before you log in, either use the CX command or set your context in the 
net.cfg file using the following statement: 
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name context = complete_name 





NOTE: For OS/2* do not use the equals sign or quotation marks. 





LOGIN Options 


Option 


INS 


/NB 


/S path | object_name 


/B 
/PR=profile_object_name 


INOSWAP 


SWAP=path 


/TREE 


Examples 


Use to 


Prevent a login script from running and prevent you from being logged 
out of other servers you are logged in to. 


Prevent the Welcome to NetWare banner from being displayed during 
the login process. 


Specify a login script file. 

Replace path with the path to the script. 

Replace object name with the object whose script you want to run. 
Specify a bindery login. 

Specify the Profile object script you want to run. 


Prevent LOGIN from swapping to extended or expanded memory, or to 
disk. 


Tells login to swap to this path when external commands are executed. 
DOS only. 


Specify that you want to log in to a tree. 


+ To log in to server PAYROLL as user MARIE without logging out of other servers you are 


logged in to, type 


LOGIN PAYROLL/MARII 


E /NS 





¢ To log in to tree TERMINAL as user MARIE, type 


LOGIN TERMINAL/MARIE /TREE 























¢ To log in to the eDirectory™ tree as user SAM (if current context is set to SAM's container), 


type 


LOGIN SAM 
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+ To log in as user SAM and specify a Profile object to use as a login script, type 





LOGIN SAM /PR=WPGROUP.NOVELL 


1.86 LOGOUT 


Purpose 


Use at a workstation to exit the network or to log out of servers. 


Syntax 





LOGOUT [server name | /T][/? | /VER] 


Parameter Use to 
(no parameter) Exit the network by logging out of all servers and eDirectory™. 
server_name Specify the server you want to log out of if you want to log out of one 


server but remain logged in to other servers or to the eDirectory tree. 
loption Replace option with any available option. 


IT Log out of eDirectory and all servers in the eDirectory tree, but not out of 
bindery servers (NetWare® 2 and 3 servers). 


1? View online help. All other parameters are ignored when /? is used. 


IVER View the version number of the utility and the list of files it uses to 
execute. All other parameters are ignored when /VER is used. 


Using LOGOUT 


You can use wildcard characters in the server name parameter. 


Examples 


+ To log out of all servers, type 


LOGOUT 


+ To log out of server MARATHON while remaining logged in to other servers, type 


LOGOUT MARATHON 
[XXX] 
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¢ To log out of all servers that begin with TEST, type 


LOGOUT TEST* 





1.87 MAGAZINE 


Purpose 


Use at the server console in response to the screen prompts Insert Magazine and Remove Magazine. 
The screen prompts refer to media magazines (hardware devices that hold several pieces of media). 


Syntax 


MAGAZINE [parameter] 





Parameter Use to 


Inserted Confirm that the media magazine was inserted in response to the Insert 
Magazine prompt. 


Not Inserted Confirm that the media magazine was not inserted in response to the 
Insert Magazine prompt. 


Not Removed Confirm that the media magazine was not removed in response to the 
Remove Magazine prompt. 


Removed Confirm that the media magazine was removed in response to the 
Remove Magazine prompt. 


1.88 MAP 


Purpose 
Use at a workstation to 


+ View drive mappings 
+ Create or change network or search drive mappings 


+ Map a drive to a fake root directory (for applications that must use a root directory) 


Syntax 





MAP [P | NP] [option...] drive:= [drive: | path] [/? | /VER] 
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Parameter Use to 


(no parameter) View drive mappings. 
P Map to a physical volume. Must be listed first or second. 
NP Overwrite local or search drives without being prompted. Must be listed 


first or second. 


option Replace option with any available option. See “MAP Options” on 
page 95. 
drive: Specify the drive you want to change. 
path Specify the path you want to map a drive to. To map to a physical volume 


on a server that is not your default server, specify the entire path 
(including server, volume, and directory name). For example, serverl / 
sys:account \pay (server/volume:directory\subdirectory) 


1? View online help. All other parameters are ignored when /? is used. 


IVER View the version number of the utility and the files it uses to execute. All 
other parameters are ignored when /VER is used. 


Using MAP 
+ Ifyou don't include drive mappings in your login script, they will have to be manually 
recreated each time the user logs in. 
+ You can have up to 26 mappings, including local drives. 
+ Search drive mappings begin with the letter Z and continue backward through the alphabet. 
+ To map a search drive, use S and a number. (See “MAP Options” on page 95.) 
+ Ifyou don't want to overwrite existing search drives, use the INS option. 


+ To map to the next available search drive, use S16:=. 


MAP Options 

Option Use to 

P Map to a physical volume. Must be listed first or second. 

Np Overwrite local or search drives without being prompted. Must be listed 
first or second. 

C Change a regular drive to a search drive, or a search drive to a regular 
drive. 

DEL Delete a drive mapping. 

INS Insert a search drive mapping without replacing an existing mapping. 

N Map the next available drive to the specified path. 

ROOT Map a drive to a fake root directory for applications that require rights in a 
root directory. 

W Do not change master environment. 
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Examples 


Ad 


To view mappings, enter 


MAP 
To map drive G: to sys :\home\jan on the current server, enter 


MAP G:=SYS:\HOME\JAN 





To extend the mapping for drive G: above to sys: \home\jan\ PROJECTS, type 





MAP G:=PROJECTS 


To map search drive 4 to PRUFROCK (server) SYS (volume) APP (directory), enter 





MAP S4:=SERVER1/SYS:APP 











To change Y: from a regular NetWare® drive to a search drive, enter 
MAP C Y: 
To delete the mapping for drive G:, enter 


MAP DEL G: 





To map drive F: to the dosgames volume of the games directory as a fake root, enter 


MAP ROOT F:=GAMES\DOSGAMES: 








n 


To map the last possible search drive to IZARD (server) SYS (volume) PUBLIC (directory), 
enter 


MAP S16:=IZARD/SYS:PUBLIC 

To map the next available drive to z: \public\dos\app from Z:\PUBLIC, enter 
MAP N DOS\APP 

To map the next available drive to michel/sys:acct\old, enter 


MAP N MICHEL/SYS:ACCT\OLD 





To insert COUNT (server) SYS (volume) PUBLIC (directory) as a new search drive, enter 


MAP INS S4:=COUNT/SYS: PUBLIC 
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+ To map to public\rpts under Volume object SYS. ACCOUNTING.ACME.US from the root, 
enter 





MAP H:=.SYS.ACCOUNTING.ACME.US: PUBLICARPTS 


Additional Information 


Topic See 


Creating login scripts “Using Login Scripts” in the Novell Login Scripts Guide 


Using Directory Map objects “Using Directory Map Objects” in the NW6.5 SP8: Traditional File 
System Administration Guide 


1.89 MEDIA 


Purpose 
Use at the server console in response to the screen prompts Insert Media and Remove Media. 


This command is used by Media Manager for the Human Jukebox. It is seldom used because most 
applications that use the Media Insert/Remove APIs register the notification routines and support 
their own methods of detecting when media is inserted or removed. This command corresponds to a 
default notification to insert or remove media if the application does not register one. It simply waits 
for the user to enter the command to notify Media Manager that a piece of media was inserted or 
removed into/from the “mailbox” slot of the computer. 


Syntax 





MEDIA [parameter] 


Parameter Use to 


Inserted Confirm that the specified media was inserted in response to the Insert 
Media prompt. 


Not Inserted Confirm that the specified media was not inserted in response to the 
Insert Media prompt. 


Not Removed Confirm that the specified media was not removed in response to the 
Remove Media prompt. 


Removed Confirm that the specified media was removed in response to the Remove 
Media prompt. 
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1.90 Memory 


Purpose 


Use at the server console to display the total amount of installed memory that the operating system 
can address. 


Syntax 


memory 


About Memory Addressing 


+ On EISA bus computers, NetWare® 3.1 and later versions address memory above 16 MB. 


+ On microchannel and ISA (AT) bus computers, NetWare (all versions) can address memory 
only up to 16 MB. 


+ On PCI bus computers, NetWare can address up to 4 GB. 


Additional Information 


Topic See 
Enabling the operating system to address memory Section 1.131, “Register Memory,” on page 160. 
above 16 MB 


1.91 Memory Map 


Purpose 


Use at the server console to display the amount of memory (in bytes) allocated to DOS and to the 
server. 


Syntax 


MEMORY MAP 





Using Memory Map 


Memory Map displays the memory allocated to DOS and to the server's memory. 
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1.92 MIRROR STATUS 


Purpose 


Use at the server console to 


¢ View the status of mirrored disk partitions 


+ View the percentage of mirrored data on each partition 


Mirror Status can be used on any NetWare mirror, regardless of type as long as all the partition types 
in the mirror match. This includes NSS, TRAD, SBD, and ISCSI devices and any other NetWare 
partition types that are mirrored. 


Syntax 


MIRROR STATUS [logical_partition_number] 


Parameter 


(no parameter) 


logical_partition_number 


Using MIRROR STATUS 


Use to 


View a list of all logical disk partitions with their mirrored status. 


Display the partition's mirrored status and the devices that make up the 
members of the mirror group. 


The possible status messages are explained in the following table. 


Status 

Being remirrored 
Fully synchronized 
Not mirrored 


Orphaned state 


Out of synchronization 


Explanation 

Remirroring is in progress; the percent completed is displayed. 

The mirrored partitions have the same data. Remirroring is complete. 
Disk mirroring was not set up for this partition. It has no mirrored partner. 


A partition has been removed from a mirrored group, and the volumes on 
the partition have not been renamed. These volumes cannot be mounted 
unless they are renamed or remirrored. 


The partition is out of synchronization with its mirrored partners and for 
some reason cannot be resynchronized. 
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Additional Information 


Topic See 


Mirroring disks (For NSS volumes) “Managing NSS Software RAID Devices” in the NW 
6.5 SP8: NSS File System Administration Guide 


(For Traditional volumes) “Using Software RAID1 Devices for Data Fault 
Tolerance” in the NW6.5 SP8: Traditional File System Administration 
Guide 


1.93 MODULES 


Purpose 


Use at the server console prompt (or at a workstation running Novell® Client™ software) to display 
a list of currently loaded modules. For each module, the command displays the following 
information: 

+ The module short name or filename 

+ Color coding that indicates the module's functional group 

¢ The address space where the module is loaded 

¢ The file from which the module was loaded 

+ A descriptive string or long name for each module 

+ The version number if the module is a disk driver, LAN driver, or NLM™ program 

+ The date on the module file 


+ Copyright information 


Syntax 





MODULES [string] 


Parameter Use to 
(no parameter) View a list of all loaded modules. 
string Display a list of all modules with names matching the string. 


The string can also contain an asterisk (*) as the last character. In this 
case, the system displays a list of module names where the names begin 
with the string. 





For example, MODULES D* displays a list of all modules beginning with 
the letter D. 
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Using Modules 


If you are using a color monitor, each module name is displayed in a color that represents the 
functional group it belongs to. 

¢ Cyan (light blue) module name indicates a module loaded by server.exe 

+ Red module name indicates a module loaded from the startup directory 

+ White module name indicates a module loaded from the autoexec.ncf file 


+ Purple module name indicates a module loaded by other modules 


The following example illustrates output of the MODULES command: 





CDBEF (Address Space = OS) 
Loaded from internal nlm list. 
NetWare Configuration DB Engine 
Version 5.00 (Build 28) April 28, 1998 
Copyright 1998 Novell, Inc. All rights reserved. 





[XXX] CPUCHECK.NLM (Address Space = OS) 
Loaded from internal nlm list. 





NetWare Processor Checking Utility 


Version 1.00 April 10, 1998 


Copyright 1998 Novell, Inc. All rights reserved. 


AHA2940.HAM (Address Space = OS) 


Adaptec 7800 Family HAM Driver for NetWare v7.00 


Version 7.00 April 22, 1998 


Copyright 1997 Adaptec, Inc. All rights reserved. 
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Additional Information 


Topic See 
Loadable modules Section 1.82, “LOAD,” on page 87 
Section 1.173, “UNLOAD,” on page 270 


Loading modules “Loading and Unloading NetWare Loadable Modules” in the NW 
6.5 SP8: Server Operating SystemAdministration Guide 


1.94 MONITOR 


Purpose 
Use at the server console to 


¢ View server statistics and activity 
+ Assess server RAM and processor utilization 
+ Set server parameter values 


¢ Print server parameter settings to a file 





NOTE: The screen saver and the console-locking features have been removed from Monitor and 
incorporated in the Scrsaver utility. 





Syntax 


[LOAD] [path] MONITOR 


Parameter Use to 

path Specify the path leading to MONITOR if you copied it to a 
directory other than the default directory. 

Using Monitor 


When Monitor is first loaded, both the General Information window and the Available Options 
menu are displayed. 
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Figure 1-4 Genral Information Window and the Available Options Menu 


Online pro 
Original 





Tab=Next window Enter=Select option Alt+Fl0=Exit Fl=Help 


The Available Options menu allows you to access additional server information, statistics, and 
settings. At some windows, you can also perform operations. 


The General Information window displays many of the key statistics that Monitor reports. 


The arrow to the left of the vertical line in the Available Options menu indicates that the menu can 
be scrolled. 


TIP: For explanations of options on Monitor menus as well as lists and statistics, you can press 
press F1 to access Monitor's online help when you are running MONITOR at the server console. 





You can press Tab to expand and activate any information window. You can press Tab again to 
toggle back to a list or menu. The active window is always highlighted in yellow. 


After a period of inactivity at the Available Options menu, the General Information screen expands 
by default to allow convenient monitoring of more critical statistics, as shown in the following 
figure. 
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Figure 1-5 MONITOR General Information Screen 
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Original 
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Tab=Next window  Alt+Fl10=Exit Fl=Help 


The following table describes the fields of General Information. 


Field 


Operating system version and 
date 


Server server name on network 
tree name 


Utilization 


Server Up Time 
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Explanation 


The version and release date of the system (upper- left corner of the 
screen). 


The name of the server and the eDirectory™ tree name. 


Average of the server's total processing capacity that was used 
during the last second (default update interval), expressed as a 
percentage. The remainder is spent in the idle loop process. 


On a uniprocessor server, this value reflects processor utilization. 


On a multiprocessor server, this value is the average utilization of all 
active processors. For utilization information about individual 
processors, select Monitor Available Options > Kernel > Processors. 


This utilization value will reflect the changes in system configuration 
as they occur, such as an NLM™ program being loaded or unloaded, 
or a volume being mounted or dismounted. 


Time elapsed since the server was most recently started. 


This value is displayed in the format DD:HH:MM:SS 
(days:hours:minutes:seconds). 


Use this information to detect power failures or to determine whether 
an intruder brought down the server. 


Field 


Online Processors 


Original Cache Buffers 


Total Cache Buffers 


Dirty Cache Buffers 


Long Term Cache Hits 


Explanation 


The number of enabled and active processors. 


The original size of the cache buffer pool, which is the number of 
cache buffers available when the server is booted. All memory not 
used to load NetWare® (code plus loader) is assigned to the cache 
buffer pool. Memory is borrowed from this pool as needed. 


The default size of a cache buffer is a 4096-byte memory page. 


The number of cache buffers currently available for file caching after 
allocating memory for NetWare. This number decreases as modules 
are loaded or memory is allocated in other ways. 


A minimum parameter controls when the server cannot continue to 
allocate file cache buffers. An alert can be set to report when the 
number of cache buffers approaches this limit. 


See Table 1-16 on page 238 for a description of these parameters. 
You can set these parameter values in MONITOR Available Options > 
Server Parameters > File Caching Parameters. You can also use the 
SET utility. 


The Disk Cache Utilization option provides additional file cache buffer 
statistics for assessing RAM. 


Number of cache buffers that contain updated data that has not yet 
been written to disk. The operating system writes the data to disk 
either as soon as the cache buffer is filled or else when the Dirty Disk 
Cache Delay Time elapses (default 3.3 seconds). 


The trade-off is between allowing small writes to wait the delay time 
and reducing the delay time by performing two writes. See “Improving 
Disk Reads on Traditional Volumes” and “Improving Disk Writes for 
Traditional Volumes” in the NW6.5 SP8: Traditional File System 
Administration Guide. Also, see “Traditional File Parameters” on 
page 237 for a description of the parameter that controls the delay 
time. 


If the number of dirty buffers is frequently above 50% of Total Cache 
Buffers, install more RAM for cache. 


A disk I/O bottleneck may be indicated if the number of dirty buffers 
remains constant and the number of Current Disk Requests remains 
high. Consider installing a faster hard disk and controller. 


Cumulative percentage of requests for disk blocks that were already 
in cache. 


Use this value to assess overall disk cache utilization. If this value 
falls below 90%, install more RAM for cache. 


Another field to check as you assess RAM is LRU Sitting Time. See 
“Tuning File Cache” in the NW 6.5 SP8: Server Memory 
Administration Guide. 
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Field 


Current Disk Requests 


Packet Receive Buffers 


Directory Cache Buffers 


Maximum Service Processes 
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Explanation 


Number of pending disk I/O requests that are queued for service. 


Use this value as a measure of the system load for the disk channel. 
If this number is consistently high, the disk and controller may be too 
slow. 


If the number of Dirty Cache Buffers exceeds 50% of Total Cache 
Buffers and server performance is slow, consider installing faster hard 
disks. 


Number of buffers that are available to the file system for holding 
client requests until they can be processed. Also referred to as 
communication buffers. The buffer size is fixed and is determined by 
the network board. The server allocates buffers as needed within 
minimum and maximum parameter values. 


For a description of these parameters, see SET “Communications 
Parameters” on page 193. You can set these parameter values in 
MONITOR Available Options > Server Parameters > 
Communications Parameters. You can also use the SET utility. 


The number of buffers available to the file system to cache the most 
frequently requested directory entries. The server allocates more 
directory cache buffers as needed within minimum and maximum 
parameter values. 


For a description of these parameters, see SET “Directory Caching 
Parameters for the Traditional File System” on page 239. You can set 
these parameter values in MONITOR Available Options > Server 
Parameters > Disk Caching Parameters. You can also use the SET 
utility. 


Maximum number of processes (threads or task handlers) the system 
will allocate to service client NCP™ requests. 


The server creates more service processes as needed within 
minimum and maximum parameters. Once memory is allocated for 
service processes, it remains allocated even when no longer 
required. Each service process requires 4 KB of RAM. 


For a description of these parameters, see SET “Miscellaneous 
Parameters” on page 213. You can increase the value of Maximum 
Service Processes using Novell Remote Manager > Set Parameters 
> Miscellaneous Parameters, using MONITOR Available Options > 
Server Parameters > Miscellaneous Parameters. You can also use 
the SET command line utility. 


Field 


Current Service Processes 


Current Connections 


Open Files 


Explanation 


Number of threads or task handlers that are currently allocated to 
service client NCP requests. 


As the number of client requests increases, the server creates more 
service processes within minimum and maximum parameters. As this 
value approaches the maximum number that can be created, server 
performance will be adversely affected. An alert appears when the 
maximum number is reached. 


For a description of these parameters, see SET “Miscellaneous 
Parameters” on page 213. You can increase the value of Maximum 
Service Processes using Novell Remote Manager > Set Parameters 
> Miscellaneous Parameters, using MONITOR Available Options > 
Server Parameters > Miscellaneous Parameters. You can also use 
the SET utility. 


Number of current active connections. This includes both licensed 
and unlicensed connections. Both licensed and unlicensed 
connections are considered active connections. A license for a 
NetWare network permits a user to connect to as many servers in an 
eDirectory tree as needed. An unlicensed connection doesn't 
consume a license. 


Connection licenses are no longer managed at the server level. 
Under Novell Licensing Services (NLS), the licensable entity is a 
NetWare network connection rather than a server connection. See 
“Overview ” in the NW 6.5 SP8: Licensing Services Administration 
Guide. 


You can view a list of active connections using Novell Remote 
Manager > Connections or using MONITOR Available Options > 
Connections. All connections described as licensed or unlicensed, 
authenticated or Not Logged-In, are considered active connections 
and are tracked by the server 


Number of files currently being accessed by the server and by other 
clients. Certain files, such as the hidden files that support eDirectory, 
are always open. 


The following table explains what information can be accessed through MONITOR options. 
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Menu Option 


Connections 


Storage Devices 
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Use to 


List active connections. 


Determine connection status—whether connections are 
licensed or unlicensed, authenticated or Not-Logged-In, or 
waiting on a lock. 


View client's network address, connection time, number of 
requests, kilobytes read, kilobytes written, semaphores 
used, and number of logical record locks. 


Determine whether logged-in user has additional rights 
corresponding to bindery Supervisor rights. 


Clear UDP and NCP connections before bringing the server 
down. Send a message to one or more client user 
connections. 





TIP: 


Press F3 to sort the items in the connection list. 





List system storage devices, including hard disks, 
controllers, adapters, media, magazines, changers, and 
slots. 


View divisions of the media's capacity given to the operating 
system, including partitions, Hot Fix™ and Mirror objects. 


View dependencies of each object. 


View per-device information, such as Media Manager object 
ID, device type, disk size and capacity, sector size, block 
size per I/O request, and number of sectors, heads, 
cylinders. 


Determine whether the device is activated, registered with 
Media Manager, marked read-inhibit, writable or write- 
protected, reserved by an application, or whether it has 
associated I/O methods. 


Determine the controller number, the device number (LUN), 
the adapter number (instance of loaded driver), driver used 
in accessing the device, and driver type (such as NWPA). 


Determine the Mirror status of the NetWare partition. 
Change the Read After Write Verify status of the hard disk. 
Activate/deactivate a hard disk. 

Mount/dismount a removable media device. 


Lock/unlock a removable media device. (If locked, the 
media can be ejected only by using a software switch.) 


Menu Option 


Volumes 


LAN/WAN Drivers 


Use to 


View per-volume mount status. 
See which file system is used on each volume. 
View per-volume information on loaded name spaces. 


View per-volume information on compression status, 
suballocation, file migration status, and number of migrated 
files. 


See whether volume is read-only. 


View per-volume information on block size, sectors per 
block, total blocks, and number of free blocks, blocks 
dedicated to file allocation table, freeable and nonfreeable 
blocks in the salvage system. 


View per-volume number of blocks dedicated to directory 
entry tables, directory entries, and directory entries in use. 


View amount of space allocated to store long names, name 
spaces, and cookies that provide the location of nearline 
and offline storage. 


List LAN driver instances loaded on the server. 


View the LAN driver version, logical board number (LAN 
driver instance), and the protocols or frame types bound to 
it. 

View node and network address. 


View generic per-driver counters for total packets 
transmitted and received, specific types of receive and 
transmit failures, adapter resets, and packets queued for 
transmission. 


View per-driver counters associated with a specific method 
of media access control or topology, such as those for 
Ethernet, token-ring, or FDDI. 


View per-driver custom counters associated with a 
particular type of model of network board. (Check the 
documentation that comes with the driver.) 


For information on each LAN driver counter, see Appendix A, 
“LAN Driver Statistics,” on page 285. 
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Menu Option 


Loaded Modules 


File Open/Lock Activity 


Disk Cache Utilization 
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Use to 


List modules loaded on the system by name. 


Recover unused memory pages (garbage collection) per 
module. 


View major version, minor version, revision number, and 
creation date of the module. 


View bytes of memory required to load this module (code, 
data, and messages). 


View amount of memory requested by the NLM™ for its use 
in bytes and nodes. View the module's load flags. 


List resources allocated by the module (resource tags). 


View resource tag memory usage. 





TIP: 


Press F3 to sort the modules by bytes of allocated memory 


or date of creation, in addition to name. 





Check a file's lock activity and status. 


View number of client connections using this file, whether 
locked, logged, or open. 


Determine number of connections opening this file 
requesting read access and write access. 


Determine number of connections opening this file 
requesting that other stations not be allowed to read or write 
to the file. 


View which clients have open files. 
View mounted volumes and directories on each volume. 


View files in a directory. 


View disk cache block request statistics, including total 
cache block requests, the number of times a block request 
had to wait because there were no available cache blocks, 
long and short term cache hits and dirty cache hits. 


Use the Long Term Cache Hits information (the percentage 
of time the operating system retrieves the data it needs 
directly from cache) to assess cache utilization. For 
explanations and guidelines, see “Assessing Server RAM” 
and “Tuning File Cache” in the NW 6.5 SP8: Server Memory 
Administration Guide. 





TIP: 


For more information on these statistics, press F1 for help 


while in this screen. 





Menu Option 


System Resources 


Virtual Memory 


Use to 


+ 


View server memory usage in bytes for the cache buffer 
pool, allocated memory in movable and nonmovable 
memory pools, code and data memory, and total server 
work memory. 


View allocated memory information for the entire system or 
for one selected system module. 


List tracked resource types and determine which modules 
use the resource. List resource tags and associated 
modules. 


Determine a module's use of resource by type, its owning 
module, address space, and amount of resource. 


Determine resource usage by owning module, address 
space, and resource type. 





TIP: 


Press F3 for sort options for Resource Tags. 





View virtual memory by address spaces or swap files. 


View the number of NLM programs loaded in each address 
space. 


View per-address space information, including number of 
times the address space faulted and restarted, and elapsed 
time since the last fault. 


View page faults statistics. 


View amount of allocated memory the NLM requested, in 
bytes and nodes. 


Recover unused memory pages (garbage collection) in the 
OS address space. 


View amount of mapped physical memory pages backing 
the OS address space. 


View statistics for page-in and page-out requests. 


View information and statistics on swap pages, including 
maximum size, minimum size, current size, free file space, 
minimum free file space, and used file space. 
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Menu Option Use to 


Kernel + View kernel information by all threads, processors, 
interrupts, and busiest threads. 


+ View the list of all threads running on the system 


In NetWare 5, all threads running on a NetWare server are 
grouped into two categories called NetWare Application and 
Java Application. To access NetWare 5 thread information, 
you select Kernel > Applications > NetWare Application [or] 
Java Application. 


In NetWare 6, threads are not categorized on the basis of 
the application. All threads can be viewed from a common 
category in MONITOR called All Threads. To view NetWare 
6 thread information, you simply select Kernel > All 
Threads. 


+ See whether a processor is online or offline. 


+ View processing load as a percentage both per-processor 
and for all processors combined. 


+ View number of threads bound to online processor. 


+ View number of interrupts fired on processor and the 
amount of time spent processing interrupts. 


¢ List all registered interrupts. 


¢ List all Interrupt Service Routines registered to a selected 
interrupt. 


+ View the number of interrupts handled by a specific Interrupt 
Service Routine, both per-processor or for all processors 
combined. 


+ Determine interrupt type and number of Interrupt Service 
Routines executed per-interrupt. 


¢ List the busiest threads in the Threads option. 


+ View per-thread information, including parent module, 
current state, reason thread is suspended, processor 
execution time, thread's stack size, soft affinity or hard 
affinity. 


Server Parameters Set values for server parameters. 


This menu provides the same functionality as the SET command. 
For descriptions of parameter categories and individual 
parameters, see Section 1.154, “SET,” on page 188. 


For a description of the MONITOR Server Parameters, see the tables for each parameter category in 
Section 1.154, “SET,” on page 188. 


Additional Information 


Topic See 


Assessing server RAM “Assessing Server RAM” in the NW 6.5 SP8: Server Memory 
Administration Guide 
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Topic See 


Checking for disk errors “Configuring and Monitoring Devices” in the NW6.5 SP8: Server Disks 
and Storage Devices 


“Checking Server Error Logs” in the NW 6.5 SP8: Server Operating 
SystemAdministration Guide 


LAN and WAN driver statistics Appendix A, “LAN Driver Statistics,” on page 285 


Clearing workstation “Clearing a Workstation Connection” in the NW 6.5 SP8: Server 
connections Operating SystemAdministration Guide 


Section 1.13, “CLEAR STATION,” on page 25 


Sending a message to a “Sending Console Messages to Workstations” in the NW 6.5 SP8: Server 
logged-in client Operating SystemAdministration Guide 
Increasing packet receive “Communications Parameters” on page 193 


(communications) buffers 
“Increasing Maximum and Minimum Packet Receive Buffers” in the NW 
6.5 SP8: Novell Server Communications Administration Guide 

Setting values of server Section 1.154, “SET,” on page 188 


parameters 
“Setting Server Parameter Values” in the NW 6.5 SP8: Server Operating 


SystemAdministration Guide 


1.95 MOUNT 


Purpose 


Use at the server console to make a volume available to users. 


Syntax 


MOUNT volume name | ALL 


Parameter Use to 

volume_name Specify the name of the volume you want to mount. 
ALL Mount all volumes not mounted. 

Using MOUNT 


+ If you set up the autoexec.ncf file to mount all volumes automatically each time the server 
comes up, then you would use the MOUNT command only if you have dismounted a volume 
and want to remount it. 


+ After you replace a removable drive, use this command to mount all volumes residing on the 
removable drive. 


+ You can mount and dismount volumes while the server is running. 
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Examples 


+ To mount volume STATISTICS, type 


MOUNT STATISTICS 


+ To mount all unmounted volumes at once, type 


MOUNT ALL 


1.96 NAME 


Purpose 


Use at the server console to display the server name. 





TIP: You can also use the SET parameter, Replace Console Prompt with Server Name = 
servername, in autoexec.ncf to display the server name with the console prompt. See SET 
“Miscellaneous Parameters” on page 213. 


This is very useful where you have multiple server consoles in one location or access several servers 
from a single management console. 





Syntax 





1.97 NCMCON 


Purpose 


Load the Novell® Configuration Manager (NCMCON) at the server to control and monitor PCI Hot 
Plug. 


PCI Hot Plug technology allows industry-standard PCI adapters to be inserted and removed without 
shutting down the NetWare® server. NCMCON displays slot configuration details, including 
adapter driver information and status. 


Syntax 


[LOAD] NCMCON 
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Using NCMCON 


The Configuration Manager Console consists of three screens: the Main menu, the Slot Options 
menu, and the Slot Detailed Information screen. 


If you want this utility to load each time the server is started, add the command to load NCMCON to 
the server's autoexec.ncf file. 


Additional Information 


Topic See 

Hot Plug architecture and “Setting Up, Enabling, and Managing PCI Hot Plug” in the NW 6.5 SP8: 
management Server Operating SystemAdministration Guide 

Purpose 


The ncopy command is a legacy DOS utility that provides two attributes to specify your intention 
for copying a compressed file to a compressed volume or a non-compressed volume.NCOPY is 
client-side application, not a server-side application. Install the Novell Client for Windows on your 
workstation, then use the Novell Map Network Drive option in the client menu to map a local drive 
letter to the sys: /public directory. Open a DOS Command Prompt window, cd to the mapped 
drive, then issue the ncopy command from the command line. You can also run a GUI version of 
NCOPY from the Novell Client by selecting NetWare Utilities > NetWare Copy, then following the 
instructions. 


Syntax 
Command Use to 

Retain compression on supported media. 
ncopy /R 

Retain compression on unsupported media. 
ncopy /R/ 


1.99 NCS Debug 


Purpose 


NCS Debug displays and saves a record of all NCS port activity in an ASCII text file named 
ncstrace.log in the sys:system directory. The size of the log file is limited to 800 KB. After the 
file reaches that size, the entries wrap around to the beginning of the file and logging continues. 
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1.100 NDIR 


Purpose 


The ndir command is a legacy DOS utility that allows you to view file attributes and compression 
information for all files in a directory. 


NDIR is a client-side application, not a server-side application. Install the Novell Client for 
Windows on your workstation, then use the Novell Map Network Drive option in the client menu to 
map a local drive letter to the sys: /public directory. Open a DOS Command Prompt window, cd 
to the mapped drive, then issue the ndir command from the command line. 


Syntax 
Command Use to 

View the file attributes for all files in a directory. 
ndir /R 

View the compression information for all files in a directory. It shows the 
ndir /COMP amount of disk space saved by compressing data. 

View the compression information for the volume. It also shows the disk 
ndir /COMP /VOL space saved on the volume. 


1.101 NETSTAT 


Purpose 
Use at the server console to monitor the network status. 


Netstat prints information about the NetWare networking subsystem. The type of information 
printed is controlled by the first argument. 


Syntax 

netstat [-aLn] [-f address family] netstat [-rn] [-f address family] netstat 
[-bdi] [-I interface] -w wait netstat [-p protocol] netstat [-s] [-f 
address family] [-1] [-I interface] netstat -help 


The following table contains a list of supported options and a description of what each does. 


Option Use To 
(none) Display the syntax for the utility. 
-a Show the state of all sockets along with the default display. (Normally, 


sockets used by server processes are not shown.) 
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-f address_family 


-| interface 


-w wait 


-p protocol 


-S 


-help 


Use To 


Display a list of ports TCP/IP is listening on. 


Display network addresses as numbers. (Normally, NETSTAT interprets 
addresses and attempts to display them symbolically.) This option can be 
used with any of the display formats. 


Limit statistics or address control block reports to those of the specified 
address_family. 


Supported address_family: inet 
Display the routing tables. 


Display the number of bytes in and out when used with the interface 
display option -i. 


Display the number of dropped packets when used with the interface 
display option -i. 


Display the state of all interfaces. If the -f address_family option is also 
used, then the -i option displays per-interface statistics on all interfaces for 
the specified address_family. 


Display information about the specified interface; used with a wait 
Interval. If the -f address_family option (with the -s option) is also used, 
then the -l interface option displays per-interface statistics on the interface 
for the specified address_family. 


Display network interface statistics at specified intervals. Replace wait 
with the number of seconds to wait between displays. 


Display statistics about the specified protocol, which is either a well- 
known name for a protocol or an alias for it. 


Supported protocols: TCP, UDP, IP, ICMP, EGP, OSPF 
Display all the protocol statistics. 


Display detailed help for this utility. 


1.102 NetWare Login 


Purpose 


Use at a Windows* 3.1x or Windows 95 workstation to 


+ Access an eDirectory tree or a NetWare® server 


+ Runa login script 


Starting NetWare Login 


By default, NetWare Login runs when you start Windows. However, you can start NetWare Login 
any time by choosing its icon in Windows. 


Depending on your Windows platform, type the appropriate executable filename: either 
LOGINW31 or LOGINW95. 


Utilities 


117 


Example: 
loginw95 /a 


An additional parameter, /A, is provided to cause the advanced tabs to appear in the NetWare Login 
dialog box. 


Open the login window on a Windows 95 workstation by clicking Start > Programs > Novell > 
NetWare Login. 


Using NetWare Login 


Use the options provided in the NetWare Login dialog box or in your Client 32™ settings. For more 
information, see the online Help for NetWare Login. 


Additional Information 


Topic See 
NetWare Login dialog box Online Help within the dialog box 
Command-line options Section 1.85, “LOGIN,” on page 91 


Client 32 settings Online Help within the dialog box 


1.103 Novell iCapture 


Purpose 


Novell iCapture LPT Port Redirector utliity lets you capture LPT ports and redirect the output to 
iPrint printers through a GUI interface. Novell ¡Capture is installed when you install the ¡Print 
Client. Before using the LPT Port Redirector, you must have iPrint printers installed on the 
workstation, and the Print Manager and Printer Agents must be up and running. 


You can use the LPT Port Redirector to also end a printer capture by selecting a port and clicking 
End Capture. 


Additional Information 


Topic See 


Using Novell iCapture “Using the Novell ¡Capture LPT Port Redirector Utility ” in the NW 6.5 
SP8: ¡Print Administration Guide. 


1.104 Novell iManager 


Purpose 
Novell iManager 2.5 is a Web-based network management application. You can use iManager to 


+ Manage your server and environment. 
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+ Configure network services. 
¢ Set up and manage your Novell eDirectory tree. 


+ Create and manage eDirectory objects. 


Additional Information 


Topic See 


Using Novell iManager “Navigating the iManager Interface” in the Novell iManager 2.7.3 
Administration Guide. 


1.105 Novell Migration Wizard 


The Novell Migration Wizard utility is a self-extracting executable that lets you copy your NetWare 
3.1x server bindery and file system across the wire and place them in a desired location in an 
existing eDirectory tree. 


The across-the-wire upgrade (also referred to as a migration) is administered on a Windows 95 or 


Windows NT workstation. 


Additional Information 


Topic See 


Novell Migration Wizard The utility's Help system. 


Migration Wizard Administration Guide 


1.106 Novell NetWare Server Consolidation 


The Novell NetWare Server Consolidation Utility helps you consolidate data and reorganize your 
network by moving data from any number of NetWare volumes (or directories within volumes) or 
NT domains to a NetWare 5.1, 6.0, or 6.5 server; to a NetWare Cluster/SAN; or to multiple NetWare 
6.0 or 6.5 servers. The Server Consolidation Utility will perform these functions either within the 
same tree or between servers in different trees. This means you have fewer servers to manage. 


In each case, the accompanying rights, trustees, ownership, and name space information are copied 
along with the files to the destination server. The Server Consolidation Utility also copies many user 
attributes from one tree to another. 


The server consolidation is administered on a Windows NT (4.0 or later), Windows 2000, or 
Windows XP Professional Edition workstation with 50 MB of available disk space. 


Additional Information 


Topic See 


Novell Server Consolidation The utility's Help system. 
Utilit 
Novell NetWare Server Consolidation Utility Guide. 
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1.107 Novell Printer Manager 


Purpose 


The Novell Printer Manager lets workstation users manage all of their Novell Distributed Print 
Services (NDPS) printing tasks including printer installation, customized printer configuration, and 
print job management. 


Users can also use the Printers folder in Windows to add NDPS printers and perform certain printer 
management tasks. 


Novell Printer Manager provides a graphical display of all the NDPS printers that are currently 
installed on a workstation. Through an easy-to-use graphical interface, users can add and configure 
additional printers for their installed printers list. 


When a user adds a printer to the workstation, the corresponding printer driver is automatically 
installed on that workstation. Administrators can specify printers to be added automatically to 
workstations through the Remote Printer Management feature of NDPS. (See Using Remote Printer 
Management (http://www.novell.com/documentation/lg/nw6p/ndps_enu/data/ 
h26ruuv3.html#h26ruuv3) in the NetWare 6 Novell Distributed Print Services Administration 
Guide.) 


Users can view real-time status and configuration information about their printers and print jobs and 
receive event notification for their print jobs. Feedback that they can receive includes information 
about the following: 

+ A printer's status 

¢ A printer's characteristics and properties 

+ A printer's features 


¢ Printer events that require operator intervention (such as low toner, empty paper tray, or 
jammed feed mechanism) 


+ A print job's status, characteristics, and properties 


Additional Information 


Topic See 
Using Novell Printer Manager Using the Novell Printer Manager Workstation Utility (http:// 
www.novell.com/documentation/lg/nw51/ndps_enu/data/htwn0jb2.html) 


in the NetWare 5.1 Novell Distributed Print Services Administration 
Guide. 


1.108 Novell Remote Manager for NetWare 


Purpose 


Use at a workstation through a Web browser to diagnose and manage NetWare® servers. The 
following main tasks that can be completed using this tool are: 


+ Diagnose server problems 
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+ Manage servers, applications, hardware 


+ Access eDirectory™ management tools 


Additional Information 


Topic See 


Complete information about accessing and using NW 6.5 SP8: Novell Remote Manager 


Novell Remote Manager for NetWare Administration Guide 
1.109 Nslookup 
Purpose 


Use at the server console to diagnose DNS setup problems or DNS problems in an application. This 
utility is similar to other Nslookup applications available in Windows and UNIX; however, this 
utility supports only the interactive mode and the commands and options listed below or in the 
online help. The interactive mode allows you to query name servers for information about various 
hosts and domains or to display a list of hosts in a domain. 


Using Nslookup 


Using this utility requires you to be familiar with how DNS works. For more information about 
DNS, see the references in “Additional Information” on page 124. 


To load Nslookup utility, enter nslookup at the System Console prompt. 


For optimum performance, Nslookup uses the sys: \system\etc\resolv.cfg file to obtain the 
DNS configuration information. If this file is mising or not configured, the Nslookup queries might 
display information that looks similar to the following: 


Figure 1-6 Message Displayed if resolv. cfg Is Missing 


Default DNS server name cannot be resolved 
Default DNS server: 6.0.6.8 
Address: 6.6.6.6 


> www.novell.com 
4.6.6.8 
Address: 6.0.6.6 


wiw.novell.com QUERY FAILED 
6.6.6.0 can’t find www.novell.com: Non-existent domain 





To resolve this problem, either configure the resolv.cfg file with the correct DNS configuration 
information and then exit and reload Nslookup or issue the following server command for Nslookup 
to use as the DNS server information for future queries: 














SERVER IP ADDRESS 


Syntax 


After loading Nslookup, use the following commands to make queries about DNS. 


Utilities 


121 


command variable| [optional] command[variable] 


The following table contains a list of supported commands and a description of what each does. 


Command 
exit 


help or ? 


Iserver 


name 


name1 name2 


root 


server name 


set option 


Description 
Exits the utility. 


Displays help for the utility at the server console. The ? can be used 
instead of entering HELP. 


Changes the default server to the specified DNS domain. The LSERVER 
command uses the initial server to look up the information about the 
specified DNS domain. This is in contrast to the SERVER command, 
which uses the current default server. 


Displays information about the host or domain name. 


Displays information about the host or domain name? but performs a 
lookup using name2 as server. 


Changes the default server to a server for the root of the DNS domain 
name space. You can change the name of the root server with the SET 
ROOT command. 


Changes the default server to name using the current server to resolve 
name 


Changes the configuration settings that affect how the lookup functions. 
For a list of supported options, see the following table. 


The following table contains a list of supported NSLOOKUP SET command options and a 
description of what each does. 


Set Option 


all 


class=value 


[no]debug 
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Description 


Displays the current values of all the configuration settings and default 
server. 


Changes the query class. 
Supported values: 
+ IN specifies the Internet class 
+ CS specifies CSNET class (obsolete in RFC 1035) 
+ CH specifies the CHAOS class 
+ HS specifies the MIT Athena Hesiod class 


+ ANY allows a wildcard query that will match any of the supported 
classes 


Default = IN 


Turns debugging mode on or off. With debugging on, more information is 
displayed about the response to each query. 


Default = nodebug 


Set Option 


[no]defname 


domain=name 


querytype=value or 
type=value 


[no]recurse 


retry=number 


root=root_server_name 


timeout=number 


Description 


Appends the default DNS domain name to any lookup request where the 
name does not end in a dot (implied name to root). 


Default = defname 
Changes the default DNS domain to the name specified. 


The default DNS domain name is appended to a lookup request 
depending on the state of the defname option. 


Default = name in the domain line of the resolv.cfg file (if it is 
present). If the domain line is not present, no default name is used. 
Queries will not use a default domain unless the SET DOMAIN=name 
command is used. 


Changes the type of information queried. More information about types 
can be found in Request for Comment (RFC) 1035 (http://www. ietf.org/ 
rfc/rfc1035.txt). The SET TYPE command is a synonym for SET 
QUERYTYPE. 


Supported values: 


+ A is the computer's IP address 
+ ANY is all types of data 
+ CNAME is the canonical name for an alias 


+ HINFO is the computer's CPU and operating system type used by a 
host 


+ MX identifies a mail exchanger for the domain 
+ NS is the authoritative name server for the domain 


+ PTR is the computer name if the query is an IP address (otherwise, 
it is the pointer to other information) 


+ SOA is the DNS domain’s start-of-authority record 
Default = A 


Tells the DNS name server to query other servers if it does not have the 
information. 


Default = recurse 


Sets the number of retries. When a reply to a request is not received 
within a certain amount of time (change with SET TIMEOUT), the 
request is re-sent before giving up. 


Default = 1 
Changes the name of the root server. This affects the root command. 
Default = AAROOT-SERVERS.NET 


Changes the initial number of seconds to wait for a reply to a request. 
When a reply to a request is not received within this time period, the 
request is re-sent the configured number of retries (changed with SET 
RETRY) before giving up. 


Default = 2 
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Additional Information 


Topic See 


Domain Names—Concepts Request for Comment (RFC) 1034 (http://www.ietf.org/rfc/rfc 1034. txt) 
and Facilities 


Domain Names— Request for Comment (RFC) 1035 (http:/Awww.ietf.org/rfc/rfc1035. txt) 
Implementation and 
Specification 


In-depth information about DNS and BIND by Paul Albitz and Cricket Liu, published by O’Reilly and 
NSLOOKUP Associates, April 2001 


1.110 NSS 


Use the Novell Storage Services (NSS) console commands to do the following: 


+ Unload NSS 

+ Display NSS module or volume information 
+ Check NSS volume statistics 

+ Change NSS caching 

+ Modify other NSS tunables 


1.110.1 Using NSS 


+ “Load Commands” on page 125 

+ “Status Commands” on page 126 

+ “Maintenance Commands” on page 127 

+ “System Volume Recovery Commands (NetWare)” on page 128 

+ “Compression Commands” on page 129 

+ “Encryped Volume Support Commands (NetWare)” on page 129 

+ “SALVAGE and PURGE Commands” on page 130 

+ “Read Ahead Commands” on page 131 

+ “Cache Balancing Commands (NetWare)” on page 132 

+ “Commands for Mounting CDs and DVDs as NSS Volumes (NetWare)” on page 133 
+ “Commands for CD and DVD Image Files as NSS Volumes (NetWare)” on page 134 
+ “DOS FAT Commands (NetWare)” on page 134 

+ “MSAP Commands” on page 135 

+ “Multipath Connection Failover Commands (NetWare)” on page 136 

+ “Pool Snapshot Commands (NetWare)” on page 137 

¢ “Security Equivalence Vector Update Commands (Linux)” on page 137 

+ “Other NSS Commands” on page 139 


For online Help for the NSS console commands, enter the following at the server console: 
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nss /help ornss /? opens the NSS console Help facility. 


The interface returns a list of NSS commands, each with a brief definition and any constraints such 
as the default value, a range of valid values, and persistence information. 


Default Value 


The default value is the setting used for a given server configuration parameter unless you modify it 
for your particular implementation. Default values are the best choice for a majority of server 
configurations, but you should review the settings as you fine-tune the server. 


Range of Valid Values 


The range of valid values establishes the constraints for any particular variable setting. 


Persistence 


If a command's setting is persistent, the values you set remain in effect for the server through any 
subsequent server reboots until you next modify the settings. If a command is not persistent, the 
setting remains in effect only until the next server reboot. 


Load Commands 


NSS provides the following startup commands. Startup commands are only valid when NSS is 
loading. 


Issuing NSS Startup Commands while OES NetWare Boots 


NSS Startup commands can run as part of the OES NetWare c: \nwserver\server.exe command 
by using the -z option. However, these commands are not persistent through a server reboot; you 
must enter them each time you boot your server. 





At the server command line, enter 
server -z“/parameter=value” 


In the above example, the -z tells the server to look for specific NSS startup commands. The 
information in quotes is the actual command with command values, if any. For example: 


server -z“CDDVD” 


Making NSS Startup Commands Persist through an OES NetWare Reboot 


NSS Startup commands issued at the command line during a server boot do not persist through a 
server reboot. To make non-persistent command settings persist automatically through a server 
reboot, place the commands in the nssstart.cfg file, which NSS reads on startup. 

1 Ina text editor, create a file called nssstart.cfg in the c: \nwserver directory. 

2 Enter any NSS startup commands that you want to persist through server reboots. 


Each NSS command should be preceded by a forward slash (/) and followed with a space. For 
example: 


/numworktodos=40 /cddvd /dosfat 


3 Save and close your c: \nwserver\nssstart.cfg file. 
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Startup Commands 


Commands 


CDDVD 


defaultNLMs 


DOSFAT 


/allLSS 


/noLSS 


/NumAsynclOs=value 


/NumBonds=value 


/NumWorkToDos=value 


IZLSS 


Status Commands 


Description 


If it is specified in the nssstart.cfg file, loads the cddvd.nss 
module that is essential for CD, DVD, and Macintosh support. 


If itis specified in the nssstart .cfg file, loads only default NSS 
NLM™ programs and any additional LSS modules specified on 
the command line. 


If it is specified in the nssstart.cfq file, loads only those 
modules that are essential for accessing FAT 16 and FAT 12 
drives. NetWare does not support FAT 32 drives. 


If it is specified in the nssstart.cfq file, it loads all LSS 
modules. 


If itis specified in the nssstart.cfq file, it does not load the LSS 
modules. 


Sets the number of asynchronous l/O entries to allocate. 
[Default=2048; Range=4 to 65536] 

Sets the number of bond entries to allocate. 
[Default=5000; Range=512 to 2097152] 


If used in the nssstart.cfq file, sets the number of WorkToDo 
entries. Entries can execute concurrently. 


NSS uses WorkToDo entries for tasks such as flushing file 
metadata to disk in the background. Increasing the number of 
WorkToDo entries might be useful on a system that is heavily 
used. NSS always reserves 20 WorkToDo entries. 


[Default=50; Range=5 to 100] 


If it is specified in the nssstart.cfg file, loads only those 
modules that are essential for ZLSS support. 


NSS provides the following commands to show the status of various NSS parameters. To view a 
complete list, use the nss /help command. 


Commands 
Status 

Pools 
PoolAutoDisplay 


Volumes 


Spacelnformation 
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Description 

Lists the current NSS status information. 

Lists all of the NSS pools that are currently available on the server. 
Displays load-time policies for pools on the server. 


Lists all of the NSS volumes that are currently mounted and active, 
including the Admin volume. 


Lists the amount of space on active pools and their associated 
volumes. 


Commands 


ListFreeSpace 


nss /StorageAlertMessages 


nss /NoStorageAlertMessages 
CompScreen 

CacheStats 

FileCacheStats 
NameCacheStats 

ResetStats 

nss /ErrorCode=code 

nss /GetMFLStatus=volume 


Modules 


Version 


Maintenance Commands 


Description 


Lists the amount of available space that has not been assigned to 
a pool. 


Enables NSS to send Low Storage messages to all users. 
[Default=On] 


Disables NSS from sending Low Storage messages to all users. 
Display the NSS Compression Statistics GUI. 

Shows the caching statistics for buffers. 

Shows the caching statistics for file system objects. 

Shows the caching statistics for names. 

Resets caching and file statistics. 

Translates and describes the specified error code. 

Shows the modified file list status for the specified volume. 


Lists the providers, loadable storage subsystems, and semantic 
agents. 


Displays the version information for NSS. 


NSS provides the following maintenance for pools and volumes. To view a complete list, use the nss 


/help command. 
Commands 


nss /BackgroundChecking 


nss /NoBackgroundChecking 
ForceBackgroundCheck 


nss /FixDirectoryQuotas=volume 


nss /FixMFL 
nss /MFL=volume 
nss /NoMFL=volume 


nss /MFLVerify=volume 


nss /IncludeType=type 


nss /OverrideType=type 


Pools 


Description 

Enables the background file system checker. 
[Default=On] 

Disables the background file system checker. 
Force background file system checking to start. 


Recomputes used space for directory quotas for the specified 
volume. 


Repairs the modified file list to be consistent with the file system. 
Enables modified file list maintenance for the specified volume. 
Disables modified file list maintenance for the specified volume. 


Compares the modified file list with the specified volume and 
reports any inconsistencies. 


Include pools of the specified type for the given command. 
Possible types are SHARED, CORRUPT, and QUESTIONS. 


Override pools of the specified type for the given command. 
Possible types are SHARED, CORRUPT, and QUESTIONS. 


Shows all of the currently available NSS pools. 
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Commands 

nss /PoolAutoDisplay 

nss /PoolAutoActivate=pool 

nss /PoolAutoDeactivate=pool 
nss /PoolAutoMaintenance=poo! 


nss /PoolAutoVerify 


nss /PoolRebuild=pool 
PoolRebuild 


nss /PoolVerify=pool 


PoolVerify 


nss /VolumeActivate=volume 
nss /VolumeDeactivate=volume 


nss /VolumeAutoActivate=volume 


nss /VolumeAutoDeactivate=volume 


nss /ForceActivate=volume 
VolumeAutoDisplay 


nss /VolumeMaintenance=volume 


nss /UpgradeObjectsOnVolume 


Description 

Displays current pool load time policies. 

Activates specified pools at load time. 

Leaves specified pools deactivated at pool load time. 

Places specified pools in maintenance mode at pool load time. 


Verifies the specified pool's physical integrity at startup time. 
(NetWare) 


Rebuilds the specified pools. (NetWare) 


Select the pools to rebuild from a menu, then it rebuilds them. 
(NetWare) 


Verifies the physical integrity of the specified pool. (NetWare) 


Allows you to select pools from a menu and verifies their physical 
integrity. (NetWare) 


Activates the specified NSS volume. 
Deactivates the specified NSS volume. 
Activates the specified volume at load time. 
Deactivates the specified volume at load time. 
Forces an NSS volume to become active. 
Displays the current volume's load time policies. 


Places a specified volume into maintenance mode. Volumes can 
be put in maintenance mode, but maintenance occurs only at the 
storage pool level. 


Upgrades objects on volumes to the current version. 


System Volume Recovery Commands (NetWare) 


NSS provides the following commands for recovering the system volume on NetWare. To view a 
complete list, use the nss /help command. 


Commands 


nss /ChangeSysQuota=size 


nss /ExpandSys 


nss /ListFreeSpace 
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Description 


Lets you change the quota (in MB) for the sys: volume. Setting 
this value to zero sets the Quota to none and allows the sys: 
volume to grow to the size of the pool. 


Lets you expand the pool that contains your sys: volume. When 
prompted, enter the partition ID of the free space you plan to use 
to expand the pool. You can obtain the partition ID of all free 
partitions by using the /ListFreeSpace command. 


Lists all free partitions and NSS partitions that have not been 
assigned to a pool. Use this command to obtain the partition ID 
required when using the /ExpandSYS command. 


Commands 


nss /RenameToSys 


nss /SalvageSys 


Compression Commands 


Description 


Lets you rename the sys: volume back to sys: if you have 
previously renamed it. At the prompt, enter the name of the 
volume you want to rename to sys:. 


Lets you restore the sys: volume if you have deleted it (only if it 
has not yet been purged). 


NSS offers the following commands for configuring and monitoring compression. To view a 
complete list, use the nss /help command. 


Command 


CompScreen 


nss /Compression=volume 


nss /Compression=all 


StopNormalCompression 


nss /BGCompression 


nss /NoBGCompression 


Description 


Displays the NSS volume compression statistics on the 
compression screen. 


Enables the Compression attribute for the specified volume. After 
you enable the Compression attribute, the setting persists for the 
life of the volume. You cannot disable compression, but you can 
set parameters to effectively turn it off. 


Enables the Compression attribute for all volumes on the server. 


Stops all queued compression for files, based on the compression 
triggered by a file open or close. 


Allows compression to occur in the background at any time, 
instead of only within specified hours. 


Stops background compression and clears any queued 
background compression requests. Allow compression to occur 
only within the specified hours. 


Encryped Volume Support Commands (NetWare) 


You can use NSS console commands to display volume status and to activate, mount, deactivate, or 
dismount encrypted volumes. You must enter a password only on the first activation following a 
system reboot. Thereafter, other environmental security and authentication measures control access 


to user data. 


The following table provides the syntax for NSS commands to use with encrypted volumes. You can 
use this syntax to activate an encrypted volume from the console command line prompt or in a script 
file. In each case, replace volname with the name of the encrypted NSS volume. In general, you 
cannot use the wildcard option of “all” as the vo/name. Until an encrypted volume is activated with 
its password following each system reboot, the All option does not find the volume and does not 
execute the command. The system returns an error message, requesting more information. 


Replace volpassword with the password you used when you created the encrypted volume. If the 
password is not supplied, and a corresponding key is not found in memory, NSS prompts for the 


password at the command line. 
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Command Use To 


nss /activate=volname:volpassword Activate the encrypted NSS volume the first time after a system 
reboot. 


nss /activate=volname Activate the encrypted NSS volume in two steps. 


If prompted, enter volpassword for The password is required only on the first activation following a 


the encrypted volume. system reboot. 

nss / Activate the encrypted NSS volume the first time after a system 
volumeactivate=volname:volpasswo reboot. 

rd 

nss /activate=all Activate all encrypted NSS volumes that have been previously 


activated with their passwords. 

nss /volumes View the status of an encrypted and non-encrypted NSS volumes. 
The encrypted volume returns a status of Encrypted. 

mount volname Mount an encrypted or non-encrypted NSS volume. 


The mount command is usable for encrypted volumes only after a 
previous activate with password. Otherwise, it returns an error 
message, requesting more information. 


mount all Activate and mount all encrypted NSS volumes that have been 
previously activated with their passwords. 


Encrypted NSS volumes that were not previously activated return 


an error message, requesting more information. 


You cannot use wildcard options and commands to activate encrypted volumes, such as nss / 
VolumeAutoActivate. 


SALVAGE and PURGE Commands 


Both PURGE and SALVAGE commands are supported and behave almost the same in NSS as in 
previous versions of NetWare. 


The SALVAGE command for the traditional NetWare file system and previous releases of NetWare 
was either turned on or off for the whole file system. In NSS, you can turn SALVAGE on or off for 
each NSS volume. 


Use SALVAGE at the server console as follows: 


Commands Description 


nss /Salvage=volume/all Enables salvage of deleted files on volumes. 
Volume enables the Salvage command on the 
specified NSS volume on the specified server. All 
enables the Salvage command on all NSS volumes 
on the specified server. 
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Commands 


nss /NoSalvage=volume/all 


Description 


Disables salvage of deleted files on volumes. 
Volume disables the Salvage command on the 
specified NSS volume on the specified server. All 
disables the Salvage command on all NSS 
volumes on the specified server. 


NSS offers the following commands for tuning the purging processes for a volume. To view a 
complete list, use the nss /help command. 


Commands 


nss / 
LogicalVolumePurgeDelay=value 


nss / 
LogicalVolumePurgeDelayAfterLoad 


nss / 
LogicalVolumePurgeDelayAfterCont 
inue= value 


nss / 
PoolHighWaterMark=<poolname>:P 
ercent 


nss / 
PoolLowWaterMark=<poolname>:P 
ercent 


Read Ahead Commands 


Description 


The number of seconds before deleted logical volumes are 
purged. This allows time to reverse the deletion. 


[Default=345600] 


The number of seconds after NSS loads before deleted logical 
volumes are purged. This allows time to reverse the deletion. 


[Default=7200] 


The number of seconds to delay purging a logical volume after 
clicking Continue. After a volume starts to purge, it cannot be 
salvaged. 


[Default=900] 


Purging begins in the salvage area when the volume's low 
watermark is reached and continues until its high watermark is 
reached. When enough files are purged such that the free disk 
space increases to a percentage equal to or greater than the high 
watermark, the autopurge stops. Autopurging does not start again 
until free space again drops below the low watermark. 


The high and low watermarks must be at least 2% apart from each 
other. 


[Default=20; Range=2 to 100] 


Purging begins in the salvage area when the volume's low 
watermark is reached and continues until its high watermark is 
reached. When free disk space falls below a low watermark, NSS 
begins autopurging the salvage area. 


The high and low watermarks must be at least 2% apart from each 
other. 


[Default=10; Range=0 to 98] 


NSS offers the following Read Ahead commands for tuning your storage solution. To view a 
complete list, use the nss /help command. 
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Commands Description 
nss /AllocAheadBlks=value Sets the number of blocks to allocate ahead on writes. 
[Default=15; Range=0 to 63] 


nss / Specify VolName as the name of the volume that you are setting 

ReadAheadBlks=VolName:Count the attribute for. Specify the Count to be the number of 4 KB blocks 
that you want to NSS to read ahead. The default block count is 2 
blocks, which satisfies the performance requirements for a typical 
volume. The valid range for a block count is 0 blocks to 1024 
blocks, where a block count of zero (0) implies no read ahead. 
However, 128 blocks is the practical maximum. 


Read-ahead block counts higher than 128 can starve other system 
components for memory or buffers, which can impair performance 
or cause the system to hang. As the number of concurrent 
connections to unique files increase, you should reduce the 
number of read-ahead blocks. 


[Default=2; Maximum=1024; Practical maximum=128] 


Cache Balancing Commands (NetWare) 
NSS provides commands to balance the cache for NSS on NetWare. 
WARNING: If you give NSS more memory than you allow for the server, NSS fails to load. Your 


NSS-based sys: volume becomes inoperable until you load the c: \nwserver\server.exe with 
an NSS override to correct the situation. For information, see “Load Commands” on page 125. 








Commands Description 
nss /CacheBalance=value Enables the dynamic balancing of free memory for the NSS buffer 


cache. Sets the specified percentage of free kernel memory that 
NSS uses for its buffer cache. [Default=85; Range=1 to 99] 


nss /NoCacheBalance Disables the dynamic balancing of free memory for the NSS buffer 
cache. 
nss /MinBufferCacheSize=value Sets the specified minimum number of NSS buffer cache entries. 


[Default=512; Range=384 to 1048576] 


nss /MinOSBufferCacheSize=value Sets the specified minimum number of NetWare buffer cache 
entries. [Default=256; Range=256 to 1048576] 


nss /NameCacheSize=value Sets the specified maximum number of Name cache entries. 
[Default=100000; Range=17 to 1000000] 


nss /CacheUserMaxPercent=value Sets the specified maximum percentage of buffer cache that can 
be used for user data. [Default=80; Range=10 to 100] 


nss /ClosedFileCacheSize=value Sets the number of closed files that can have their beast objects 
cached in memory. On average, each Closed File Cache entry 
consumes 0.4 - 1KB of RAM. 


[Default=50000; Range=16 to 1000000; Recommended=100000] 


CacheStats Shows the caching statistics for buffers. 
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Commands Description 


FileCacheStats Shows the caching statistics for file system objects. 
NameCacheStats Shows the caching statistics for names. 
ResetStats Resets caching and file statistics. 


nss /FlushFiles|lmmediately=volume Synchronously flush data to the specified volume when its files are 
closed instead of waiting for the next scheduled write of data to the 
volume. 


nss / Disables synchronously flushing files to the specified volume when 
NoFlushFileslmmediately=volume its files are closed. Instead, data is written to the volume on the 
next scheduled write of data to the volume. 


nss /FileFlushTimer=value Sets the flush time in seconds for writing data to modified open 
files. Increasing this number might reduce the number of writes to 
disk; however, it increases the amount of data that is lost if the 
system crashes. 


[Default=10 seconds; Range=1 to 3600 seconds] 
nss /IDCacheResetInterval Set the number of seconds between invalidation of the ID cache. 


[Default=90000 Range=0-200000000] 


Commands for Mounting CDs and DVDs as NSS Volumes (NetWare) 


Cddvd.nss 1s loaded automatically on startup by default. Use the following commands to manage 
CDs, DVDs, and Macintosh CDs as NSS volumes on Netware. 





NOTE: The cddvd.nss module replaces cdrom. nlm and cd9660.nss for CD support, udf .nss 
for DVD support, and cdhfs.nss for Macintosh CD support. The following commands for 
cddvd.nss are the same ones used for previous CD and DVD management modules. 





Commands Description 


CDDVD If CDDVD is specified in the nssstart .cfg file, loads only those 
modules essential for CD and DVD support. 


nss /(No)LeaveCDinNDS If the switches UpdateCDToNDS or LoginUpdateCDToNDS is 
enabled, enable this switch to retain the CD or DVD volume 
objects when the actual disks are removed. 


[Default=Off] 


nss /(No)LoadISOVolumeFirst If this switch is enabled, tries to load UDF-bridge CD as and 
1509660 volume first. By default, a UDF-bridge CD is loaded as 
DVD format first and CD format second. 


[Default=Off] 


nss /(No)LockCDMedialn If this switch is enabled, whenever CDs or DVDs are activated or 
deactivated as NSS volumes, locks or unlocks the media in the 
device. 


[Default=Off] 
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Commands 


nss /(No)UpdateCDToNDS 


nss /(No)LoginUpdateCDToNDS 


nss / 
(No)MountISODiscSetInOneVolume 


Description 


If this switch is enabled, whenever CDs or DVDs are activated or 
deactivated as NSS volumes, updates their Novell eDirectory 
objects. 


[Default=Off] 


If this switch is enabled, whenever CDs or DVDs are activated or 
deactivated as NSS volumes, updates their Novell eDirectory 
objects. You must login as admin. 


[Default=Off] 


If this switch is enabled, cddvd.nss attempts to load an ISO9660 
multiple-disk set as a single NSS volume. This volume is not 
mounted until all disks among the set are available to cddvd.nss. 


If this switch is disabled, cddvd.nss mounts each disk in the set 
as one individual NSS volume. 


[Default=Off] 


Commands for CD and DVD Image Files as NSS Volumes (NetWare) 


Cddvd.nss is loaded automatically on startup by default. cddvd.nss provides the following 
commands for adding and removing CD and DVD image files as NSS Volumes. 


While the CD or DVD image source file is loaded as an NSS volume, the following actions cause 
the image file to be removed as an NSS volume: 


+ Any file operations on the image source file, such as open, read, or write 


+ Deactivation of the NSS volume where the image source file resides 


Commands Description 
nss / Adds and mounts the specified CD or DVD image file as 
MountlmageVolume=path_imagefilename a read-only NSS volume. 
Replace path_imagefilename with the path on the NSS 
volume where the image file resides, including its 
filename. For example: 
nss /MountImageVolume=nssvol:\suse9_1.iso 
nss / Dismounts and removes the specified CD or DVD image 


RemovelmageVolume=path_imagefilename file as a read-only NSS volume. 


Replace path_imagefilename with the path on the NSS 
volume where the image file resides, including its 
filename. For example: 


nss /RemovelmageVolume=nssvol:\suse9_1.iso 


DOS FAT Commands (NetWare) 


NSS provides the following commands for managing DOS FAT partitions. 
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Commands 


DOSFAT 


nss / 
FATPartition=partition_type_number 


nss /(No)FATLongNames 


Description 


If DOSFAT is specified in the nssstart.cfg file, loads only 
those modules essential for accessing FAT 16 and FAT 12 drives. 
OES NetWare does not support FAT 32 drives. 


Supports up to three additional partition types containing 16-bit 
FATs, such as /FATPartition=12, 13. 
Enables long filenames on FAT volumes. 


[Default=On] 





NOTE: DOSFAT supports only hard drives. DOSFAT does not support USB drives. 





MSAP Commands 


The management file for pool MSAP is_admin\manage_nss\pool\poolname\zlss\msap.xml. 
One file exists for each pool. This file contains MSAP statistics for the pool. The MSAP attribute is 
displayed in the enabledAttributes tag of the poolinfo.xm1 management file. 


For manage.cmd, the pool operation getPoolInfo returns the MSAP tag (<msap>) in the 
supportedAttributes tag (<supportedAttributes>) and the enabledAttributes tag 


(<enabledAttributes>). 


For APIs, the pool feature zpool_feature_msap can be viewed and controlled using the zGetInfo and 


zModifyInfo commands. 


MSAP Console Command 


nss /msapserver 


nss /nomsapserver 


nss /msaprebuild 


nss /poolmsap=poo! 


nss /nopoolmsap=poo! 


nss /pools 


Description 


Enables MSAP for all the pools on the server. By default, MSAP is 
enabled for every pool on the server. We recommend that you 
never disable MSAP. 


Disables MSAP for all the pools on the server. This command 
remains in effect only until the server is next rebooted. We 
recommend that you never disable MSAP. 


Rebuilds a corrupt MSAP block. Before issuing the command to 
rebuild, you must deactivate the pool because a corrupt MSAP 
prevents a pool from going into Maintenance state. Rebuilding an 
MSAP block does not give the rebuilder ownership of the pool. 


Enables MSAP for a given pool on the server. MSAP is enabled 
the next time the pool is activated. (Enter the command, 
deactivate the pool, then activate the pool. MSAP is now enabled.) 


Disables MSAP for a given pool. Use the command when the pool 
is activated. MSAP is disabled the next time the pool is activated. 
(Enter the command, deactivate the pool, then activate the pool. 
MSAP is now disabled.) 


Displays the message “Multi-use detect” for pools that have MSAP 
enabled. 
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Multipath Connection Failover Commands (NetWare) 


NSS provides the following Media Manager commands for managing multipath connection failover. 


Media Manager Multipath 1/0 Console 


Command Description 


list failover devices device_id This command lists all of the failover devices. It also lists all the 
paths associated with each device, their assigned priorities, and 
the path that is selected. 


To list the paths associated with all the devices on the server, enter 
the command without specifying the device_id. 


To list the paths associated with a given device, enter the 
command followed by the device_id. 


mm set failover priority This command sets the priority level for the selected path. The 

pathid=number pathid must be a valid path ID. The number is the priority to set for 
the selected path. The number must be a decimal integer value 
between 1 and 4 million, with 1 being the highest priority and 4 
million being the lowest priority. 


mm set failover priority The /insert option inserts the specified path with its specified 

pathid=number /insert priority. For example, if you have four existing paths that are 
assigned the priorities of 1, 2, 3, and 4, and you enter a new path 
followed by a number 2 and the /insert option, then the paths that 
were previously assigned to 2, 3, and 4 priority are bumped to 
priority 3, 4, and 5 in order to accommodate the new path that has 
been assigned priority 2. 


mm set failover state pathid=up / This command sets the state of the specified path to Up. The 
setpath pathid must be a valid path ID. 


If the Up option is followed by the /setpath option, NSS 
automatically selects the highest priority path from among all the 
paths that are in the Up state, including the new path. 


mm set failover state pathid=down / This command enables you to designate a path to be in the Down 

setpath state so you can perform preventative maintenance or reroute 
cables on a good, functional path. If the path is bad, NSS 
automatically moves the path to a Down state. 


If the Down option is followed by the /setpath option, NSS 
automatically selects the highest priority path from among the 
other paths that are currently in the Up state. 


mm set failover path pathid This command activates the selected path as selected, which 
means it serves as the primary path. The pathid must be a valid 
path that is currently in the Up state. The priority of a path remains 
static regardless of whether a path is considered up or down or 
whether a path is selected or not selected as the primary path. 


mm restore failover path device_id This command forces the device to reselect the highest priority 
path that is online. The deviceid must be a valid device ID. 


mm reset failover registry This command resets the multipath settings in the operating 
system registry. 
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Pool Snapshot Commands (NetWare) 


The following table shows the server console commands you can use to manage pool snapshots. 


Snapshot Management Commands 


mm snap create snappoo! datapool 
snapname 


mm snap activate snapname 

mm snap deactivate snapname 

mm snap delete snapname 

mm snap rename snapname newsnapname 
mm snap list 


mm snap shred snapname = on 


mm snap shred snapname = off 


Description 


Creates a pool snapshot. 


Activates a pool snapshot. 
Deactivates a pool snapshot. 
Deletes a pool snapshot. 
Renames the pool as specified. 
Lists the snapshots on the server. 


Turns on shredding for the internal volume of the pool 
where you are storing the specified snapshot. 


If this option is enabled: 


+ You can have only one snapshot at a time of its 
original pool. 


+ After you delete the snapshot, allow enough time 
for the shredding process before you create a new 
one. 


Turns off shredding for the internal volume of the pool 
where you are storing the specified snapshot. 


If any pool snapshot was created on this pool prior to the 
NetWare 6.5 SP3 release, shredding is already turned 
on. Use this command to turn off shredding. 


The following table shows the attribute descriptions for pool snapshot commands. 


Attributes for Pool Snapshot Commands 


snappool 


datapool 


snapname 


Description 


The unique name of the original data pool that you are 
snapping; must be 2 to 16 characters. 


The unique name of the stored-on pool for the pool 
snapshot; must be 2 to 16 characters. 


The unique snap name of the pool snapshot, which is 
used as its pool name when the pool snapshot is 
activated; must be 2 to 16 characters. 


Security Equivalence Vector Update Commands (Linux) 


The Security Equivalence Vector (SEV) is calculated for each NSS user based on information in the 
user's profile in Novell eDirectory. It is a list of eDirectory GUIDs, for example: 


+ the user's own GUIDs 


+ GUIDs of groups that include the user 
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+ GUIDs of parent containers for the user and his or her groups 


¢ security equivalent GUIDs 


The SEV is used to validate the user against the trustee rights of the directory and file the user is 


attempting to access. 


After you boot the Linux server, when a user first attempts to connect to the NSS file system, NSS 
contacts Novell eDirectory to retrieve the user's Security Equivalence Vector (SEV). eDirectory 
calculates the user's effective rights for the NSS volume, creates the SEV, and passes it to NSS. NSS 
compares the user's SEV with file system trustees and trustee rights for the specified file or directory 
to determine if the user can access the resource. 


NSS caches the SEV locally in the server memory, where it remains until the server is rebooted or 
unless the user is deleted from eDirectory. NSS polls eDirectory at a specified interval for updates to 


the SEVs that are in cache. 


In contrast, for NetWare, whenever a user connects to the NSS file system, NetWare retrieves the 
user's SEV from eDirectory and maintains it as part of the connection structure for the user's session. 
NSS retrieves the user's SEV from the connection structure. 


Command line switches are available in the NSS Console utility (nsscon) to enable or disable the 
update, to set the update interval from 5 minutes to 90 days (specified in seconds), and to force an 
immediate update of security equivalence vectors. Polling too frequently can impact performance. 
Polling too infrequently can cause delays in granting or restricting access to certain users. 


NSSCON Command 


nss /SecurityEquivalenceUpdating 


nss /NoSecurityEquivalenceUpdating 


nss / 
UpdateSecurityEquivalencelnterval=valu 
e 
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Description 


Enables SEV updates to occur in the background in adatition 
to updates that occur when the system reboots. It is enabled 
by default. 


To make it persistent, include the command in the /opt / 
novell/nss/conf/nssstart.cfg file. 


Disables SEV updates to occur in the background. Instead, 
SEV updates occur only on system reboot. 


To make it persistent, include the command in the /opt / 
novell/nss/conf/nssstart.cfg file. 


Sets the SEV update interval to the specified value in 
seconds. At the end of the elapsed time, NSS reaquires 
updated SEVs from eDirectory. 


To make it persistent, include the command in the /opt / 
novell/nss/conf/nssstart.cfg file. 


The default value is 7200 (2 hours). The valid range is 300 (5 
minutes) to 7257600 (90 days). 


NSSCON Command 


Description 


nss /ForceSecurityEquivalenceUpdate Forces the SEV update to occur immediately for all users in 


Other NSS Commands 


the NSS file system. Use this command if you modify a user's 
access control settings in eDirectory and want those changes 
to be reflected immediately in the user's active SEV for this 
server. 


This command is invalid if used in the /opt/novell/nss/ 
conf/nssstart.cfg file. 


A unique abbreviation such as 
nss /ForceS 


also works. 


NSS provides these additional commands for managing pools and volumes. To view a complete list, 


use the nss /help command. 


Commands 


nss /NoClassicDirectoryQuotas 


nss /DataShredding=volume:count 


nss /NoDataShredding=volume 
nss /DirectoryQuotas 

nss /NoDirectoryQuotas 

nss /FileCopyOnWrite 

nss /NoFileCopyOnWrite 


nss /LVDeleteStatusBasic 

nss /LVDeleteStatusSalvagable 
nss /Migration=volume/all 

nss /NoMigration=volume/all 


nss /StorageAlarmThreshold=value 


Description 
Turns emulation of Traditional NetWare volumes on or off. 
[Default=Off] 


Enables the Data Shredding attribute for the specified volume. 
Specify the number of times you want to shred data. 


Data shredding overwrites purged files with bit patterns up to 
seven times. Unless you must use this feature for security 
reasons, it should be disabled, as data shredding consumes a 
great deal of disk I/O bandwidth. 


[Default=1; Range=0 to 7, where 0 indicates no shredding] 
Disables data shredding on the specified volume. 

Enables directory quotas on the volume. 

Disables directory quotas on the volume. 

Creates a copy of files in the volume when they are open for write. 


Does not create a copy of files on the volume when they are open 
for write. 


Displays information about deleted logical volumes. 
Displays information about salvagable logical volumes. 
Enables migration of files on the volumes. 

Disables migration of files on the volumes. 

Lets you set the threshold for a low storage space warning. 


[Default=10; Range=0 to 1000000] 
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Commands Description 

nss /(No)StorageAlertMessages Turns On or Off the low storage message to users. 
[Default=On] 

nss /StorageResetThreshold=value Lets you reset the threshold for a low storage space warning. 


[Default=10; Range=1 to 1000000] 


nss /NoTransaction=volume/all Disables transactional writes in files on the volumes. 

nss /UserSpaceRestrictions Enables user quotas on the volume. 

nss /NoUserSpaceRestrictions Disables user quotas on the volume. 

nss /Transaction=volume/all Enables transactional writes in files on the volumes. 

nss /ZLSSIOStatus Displays current NSS IO status information. 

nss /ZLSSPendingWritelOs Number of write inputs dropped to the storage subsystem. (0 = all 
available) 


[Default=1000; Range=0 to 3000] 
nss /ZLSSPoolScan Scans for and loads all ZLSS pools. 


nss /ZLSSVolumeUpgrade Allows the 5.x/ZLSS VolumeUpgrade to the NetWare 6 format to 
occur during the installation process. 


1.110.2 Additional Information 


Topic See 


Using commands and other NW 6.5 SP8: NSS File System Administration Guide 
management tools 


1.111 NSSMU 


Purpose 


The Novell Storage Services™ Management Utility (NSSMU) is a console-based utility for 
managing NSS storage media on a server. You can use it at any time as an alternative to the browser- 
based iManager Storage Management plug-in. 


NSSMU for NetWare 


NSSMU is the interface you use to set up your basic NSS storage solution during the NetWare 
installation. For example, you must use NSSMU to create the sys pool and sys: volume. 


For OES NetWare, you can set up iSCSI partitions using the Partitions option in the main menu in 
NSSMU. You must have iSCSI target software loaded to make your server an iSCSI disk server. You 
cannot create iSCSI devices during the initial installation. For more information, see the NW 6.5 
SP8: ¡SCSI 1.1.3 Administration Guide. 
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For OES NetWare, you can use NSSMU and Novell Remote Manager to create encrypted volumes. 
Encryption is an optional volume attribute, available only at volume-creation time. An encrypted 
volume meets the legal standard of making data inaccessible to software that circumvents normal 
access control, such as if the media were stolen. You cannot create encrypted volumes during the 
installation. The sys: volume is not eligible for encryption. 





IMPORTANT: NSSMU is not meant to replace iManager or any other NetWare file system 
management utilities. However, it is the only management tool that can access your server if you 
accidentally delete or rename the sys: volume. 





Load the NSSMU module (nssmu. n1m)from the command line of the server console by entering 


nssmu 


The following table identifies key functions available in NSSMU for NetWare. 


Management Options 


Device Management 


Pool Management 


Function Keys 

F1 = Help 

F2 = Scan for devices 

F3 = Initialize device (not for sys:) 


F4 = Multipath (available only if there are 
multiple paths for the device) 


F5 = Select/Deselect one or more devices for 
Initialize or Share actions 


F6 = Share (Sharable/Not sharable for 
clustering) 


F9 = Refresh details of the device 
Enter = Show partitions 

Ins = Create a pool 

Del = Delete a pool 

F3 = Expand a pool (add segments) 
F5 = Refresh details of the pool 

F6 = Rename a pool 

F7 = Activate/Deactivate pools 

F8 = More (list more options) 

F9 = Show/Hide deleted volumes 
F10 = List devices (that a pool resides on) 
Alt+F8 = Update NDS®/eDirectory™ 


Enter = Show volumes (on a server or pool) 


Description 


Use this menu option to 
initialize and maintain a wide 
selection of physical storage 
devices and software RAID 
devices available to this 
server. Use the RAID Devices 
option to create and expand 
software RAID-0, RAID-1, and 
RAID-5 devices. 


Use this menu option to 
create, delete, rename, and 
expand NSS storage pools to 
efficiently use all free space in 
the available devices. 
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Management Options Function Keys Description 


Volume Management Ins = Create an encrypted or unencrypted Use this menu option to 
volume create, delete, rename, 
activate/deactivate, and 

Del = Delete a volume mount/dismount volumes and 


F3 = Rename a volume to set volume attributes. 


To store data in encrypted 
format, enable the encryption 
F6 = Deactivate/Activate an encrypted or attribute on volume creation. 
unencrypted volume. If encrypted, the volume The encryption setting persists 
prompts for a password on the first activate forthe life of the volume. The 


F5 = Refresh details of the volume 


after a system boot or reboot. encryption password can be 
up to 16 standard ASCII 
F7 = Dismount/Mount a volume characters, with a suggested 


minimum of six. The password 
generates a 128-bit NICI key 
Alt+F8 = Update NDS/eDirectory for encryption. Supply the 
password on the first volume 
Enter = Properties (change volume properties) activate after a system boot or 


F8 = More (list more options) 


reboot. 
Software RAID Ins = Create a Software RAID (0, 1, or 5) A software RAID device 
Management emulates a hardware RAID 
Del = Delete a software RAID device device. RAID devices combine 


partitioned space on multiple 
physical devices into a single 
F5 = Refresh details of the software RAID virtual device that you manage 
device like any device. Each member 
device contributes an equal 
F6 = Restripe (resume restriping for paused amount of space and only a 


F3 = Expand a RAID device (add segments) 


RAID 0/5) single segment to the RAID. 
F8 = Show pools (list pools on selected RAID You can also create a software 
0 or 5; for RAID 1, its single member pool RAID 10 pool by mirroring a 
appears in device details) pool on software RAID 0 


devices, which must have no 
physical drives in common. 
Create a pool on one of the 
RAID 0 devices, then mirror 
the pool on up to three 
software RAID 0 devices, 
totalling up to four segments 
for the RAID 10 pool. 


Enter = Show segments (list member 
segments) 


Partitions Ins = Create an NSS or an iSCSI partition Use this option to create and 
, 7 manage NSS partitions and 
Del = Delete an NSS or an iSCSI partition iSCSI partitions. To create 
iSCSI partitions, the server 
must run iSCSI target software 


F5 = Refresh details of the partition and be the server you plan to 
make your iSCSI disk server. 


F3 = Mirror (create a software RAID-1 device) 


Enter =Show volumes 
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1.112 NSWEB 


Purpose 


Use NSWEB and NSWEBDN to start and stop the NetWare® Web Manager and NetWare 
Enterprise Web Server. 


Syntax 


NVXWEBUP 





NVXWEBDN 





1.113 NVXADM 


Purpose 


Use NVXADMUP and NVXADMDN to start and stop the NetWare® Web Manager. 


Syntax 


NVXADMUP 


NVXADMDN 


1.114 NVXWEB 


Purpose 


Use NVXWEBUP and NVXWEBDN to start and stop the NetWare® Web Manager. 


Syntax 


NVXWEBUP 





NVXWEBDN 
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1.115 NWBACK32 


Purpose 


From a Windows* 95 or Windows NT* workstation, use this graphical utility to back up or restore 
Storage Management Services™ (SMS™) targets such as eDirectory™, binderies, the file system, 
or hard disks. With this utility, you can do the following: 


+ Back up data 

+ Restore data 

+ Verify what you have backed up or restored 
+ Create new sessions 

+ Manage your devices 

+ Manage your backup or restore jobs 

¢ Create log and error reports 


¢ Schedule backup or restore jobs 


Starting NWBACK32 


Certain prerequisites must be met on the backup server before you can start NWBACK32 ona 
Windows 95 or Windows NT workstation. Also, if you are loading NWBACK32 for the first time, 
the steps are different. For more information, see the NW 6.5 SP8: Storage Management Services 
Administration Guide and the NW 6.5 SP8: SBCON Administration Guide. 

1 Log in to the desired eDirectory tree. 

2 Select Network Neighborhood > Novell > sys:public > Nwback32. 


The Quick Access window appears. 


Figure 1-7 Quick Access Window 





Quick Access 121 x] 


Select a Task : 





BACKUP DEVICE ADMINISTRATION 


RESTORE JOB ADMINISTRATION 


VERIFY REPORTS 
CREATE SESSION EXIT 


[ea] [ss 
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Using NWBACK32 


The following sections describe how the elements of NWBACK32 work. There are three methods 

for using NWBACK32: Quick Access, the toolbar, or the menu bar. Use the Quick Access window 
to determine what you want to back up or restore. Then Quick Access window does not contain as 

many features as in the menus or toolbar. 


Interface 


Click the preferred button in the Quick Access window: 


+ 


5 


+ 


5 


Ad 


+ 


+ 


+ 


Backup lets you choose what to back up and where to back up. 

Restore lets you choose what to restore and where to restore. 

Verify lets you check the data on your media to ensure a successful backup. 
Create Session lets you create you log and error file sessions. 

Device Administration lets you monitor the properties of a device. 

Job Administration lets you view and change jobs. 

Reports lets you view the details of session and error reports. 

Exit quits NWBACK32. 


When you reach your destination, in most instances you can right-click the last item. You may also 
use the menu bar or the toolbar to complete the task. 


Bar 


The menu bar displays headings for various menus. The tasks in the menus contains all the features 
the toolbar uses and more than the Quick Access menu. To complete a task or manage a job, select 
one of the following if preferred: 


5 


+ 


+ 


+ 


+ 


5 


File contains options for a new session, changing the context, changing the protocol, or exiting 
NWBACK32. 


Backup contains options for submitting a job, using filters, selecting a backup type, scheduling 
a backup, or selecting the backup frequency. 


Restore contains options for submitting a job, using the filters, and scheduling a restore. 
Verify contains an option for submitting a job. 
Create Session contains an option for submitting a job. 


Device Administration contains options for changing device labels or types, attaching to 
media, releasing a device, viewing media properties, erasing the media, moving the media, 
retension the media, or create a new media label. 


Job Administration contains options for checking properties of jobs, enabling or deleting 
jobs, starting or holding jobs, rescheduling a job, or aborting a job. 


Reports contains options for creating new log and error reports. 


The toolbar displays buttons for various tasks or topics as follows: 


+ 


Ad 


+ 


Start a backup initializes your backup job. 
Start restore job initializes your restore job. 


Start verify session initializes verification of data on the media. 
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¢ Start create session initializes a new session for the job. 


¢ Job administration contains options for checking properties of jobs, enabling or deleting jobs, 
starting or holding jobs, rescheduling a job, or aborting a job. 


¢ Device administration contains options for changing device labels or types, attaching to 
media, releasing a device, viewing media properties, erasing the media, moving the media, 
retension the media, or create a new media label. 


+ Reports lets you create a log or error report. 

+ Run lets you run a report. 

+ Apply filters lets you use the filters you selected in Backup. 

+ Complete differential and incremental backup lets you run these backup types. 
+ Schedule the job lets you schedule your backup or restore. 

¢ Frequency of backup lets you indicate how often to back up. 

+ Change the context lets you change to another context. 

+ IP/IPX lets you change the protocol. 

¢ Help displays the Help facility (not yet available). 

+ Exit closes NWBACK32. 


Additional Information 


Topic See 

Learning how backup and restore works “SMS Overview” in the NW 6.5 SP8: Storage 
Management Services Administration Guide 

Backing up data “Backing Up Data Using SMS” in the NW 6.5 SP8: 
Storage Management Services Administration 
Guide 

Restoring Data “Restoring Data Using SMS” in the NW 6.5 SP8: 
Storage Management Services Administration 
Guide 

Loading the backup software “Installing and Configuring SMS” in the NW 6.5 
SP8: Storage Management Services Administration 
Guide 

Administering a job or a device “Using SMS” in the NW 6.5 SP8: Storage 


Management Services Administration Guide 


1.116 NWCONFIG 


Purpose 
Use at the server console to 


+ Modify your NetWare® server's configuration 
+ Perform server management operations 


¢ Install additional products 
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Syntax 


[LOAD] [path]NWCONFIG 


Parameter 


path 


Using NWCONFIG 


Use to 


Specify the path to NWCOMFIG if you moved it from the default directory. 


The following table describes each option found on the NWCONFIG main menu. 





NOTE: For information about NWCONFIG options, press F1 from any NWCONFIG window. 





Table 1-1 NWCONFIG Installation Options Menu 


Menu Option 


Driver Options 


Legacy Disk Options 


License Option 


Copy Files Option 
Directory Options 


NCF Files Options 
Multi CPU Options 


Product Options 


Exit 


Additional Information 


Topic 


eDirectory 


.ncf files 


Use to 


This functionality has been moved to the Hardware Detection utility, 
hdetect.nlm. 


These options are now provided by Novell iManager, Novell Storage 
Services Management utility (nssmu . n1m), and Novell Remote Manager 
(NRM). 


Use iManager to install or delete licenses. 
Copy NetWare files to various directories on volume sys: . 


Install and remove eDirectory. Upgrade mounted volumes into the 
eDirectory tree. Perform eDirectory tree backup and restore options 
Extend schema. 


Create and edit the startup.ncf and autoexec.ncf files. 


This functionality has been moved to the Hardware Detection utility, 
hdetect.nlm. 


Install and configure additional NetWare or third-party products; remove 
additional products from the server. Add an additional language to the 
server or change the server language. 


Exit NWCONFIG. 


See 


“Maintaining Novell eDirectory” in the Novell eDirectory 8.8 
Administration Guide 


Overview to “Using Server Batch Files” in the NW 6.5 SP8: Server 
Operating SystemAdministration Guide 
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1.117 NWPING 


Purpose 
Use at the server console for remote host reachability diagnosis. 


The NWPING utility sends a packet to the specified host and waits for a reply. The host address and 
roundtrip times for each pair of packets are displayed. In addition, the total number of packets sent; 
total number of packets received; percent packet loss; and the minimum, average, and maximum 
roundtrip times are displayed when the program exits. 


Syntax 
nwping [-afnq] [-c count] [-i wait] [-1 preload] [-p pattern] [-s 
packetsize] [-S src_addr] [-t timeout] [host] [-help] 


The following table contains a list of supported options and a description of what each does. 


Option Use to 

-a Include a bell (ASCII 0x07) character in the output when any packet is 
received. 

-f Output packets as fast as one hundred times per second. For every 


ECHO_REQUEST sent, a period ( . ) is printed; for every ECHO_REPLY 
received, a backspace is printed. This provides a rapid display of how 
many packets are being dropped. This can be very hard on the network 
and should be used with caution. 


-n Display numeric output only. No attempt will be made to look up symbolic 
names for host addresses. 


-q Quiet output. Nothing is displayed except the summary lines at startup 
and completion. 


-c count Stop after sending (and receiving) count ECHO_RESPONSE packets. If 
this option is not specified, NWPING operates until interrupted. 


-i wait Specify the time interval (in seconds) between packet sends. This option 
is incompatible with the -f option. 


Minimum: 1 
Maximum: 10 


-| preload Send packets as fast as possible before falling into normal mode of 
behavior. 


Maximum: 100 


-p pattern Diagnose data-dependent problems in a network. You can specify up to 
16 pattern bytes to fill out the packet you send. Length should be 16. 


Example: -p 01234567891 Oabcdef 
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Option Use to 


-s packetsize Specify the number of data bytes to be sent. 
Maximum: 36992 


Default: 56 (equals 64 ICMP data bytes when combined with the 8 bytes 
of ICMP header data) 


-S src_addr Use the IP address as the source address in outgoing packets. On hosts 
with more than one IP address, this option can be used to force the 
source address to be other than the IP address of the interface that the 
probe packet is sent on. If the IP address is not one of this machine's 
interface addresses, an error is returned and nothing is sent. 


host Specify the destination host that the connection needs to be checked on. 
-help Display the help for this utility. 

1.118 NWTrace 

Purpose 


Use at the server console to print the route that packets take to the network host. 


NWTrace utilizes the IP Protoco time-to-live field and attempts to elicit an 

ICMP_TIME EXCEEDED response from each of the gateways along the path to a host, to track the 
route the packets follow. The only mandatory parameter is the destination hostname or IP address. 
The default probe datagram length is 40 bytes, but this can be increased by specifying a packet 
length (in bytes) after the destination hostname. 


Syntax 


NWtrace [-Snv] [-M min_ttl] [-m max_ttl] [-q nqueries] [-s src_addr] [-w 
wait_time] host [packetlen] 


Option Use To 
-S Print a summary of how many probes were not answered for each hop. 
-n Print hop addresses numerically only rather than numerically and 


symbolically (saves a nameserver address-to-name lookup for each 
gateway found on the path.) 


-V Get verbose output. The received ICMP packets other than 
TIME_EXCEEDED and UNREACHABLEs are listed. 


-M min_ttl Set the initial time-to-live value used in outgoing probe packets. 
Default: 1 (start with the first hop) 


-m max_ttl Set the maximum time-to-live (max number of hops) used in outgoing probe 
packets. 


Default: 30 (default max_ttl used for TCP connections) 
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Option Use To 


-q nqueries Set the number of probes per hop. 
Default: 3 
-s src_addr Use the specified IP address (that must be given as an IP number, not a 


hostname) as the source address in outgoing probe packets. On hosts with 
more than one IP address, this option can be used to force the source 
address to be other than the IP address of the interface the probe that the 
packet is sent on. If the IP address is not one of this machine’s interface 
addresses, an error is returned and nothing is sent. 


-w wait_time Set the time (in seconds) to wait for a response to a probe. 


Default: 5 


1.119 PING 


Purpose 


Use at the server console to send an Internet Control Message Protocol (ICMP) echo request packet 
to an IP node on your internetwork. 


PING determines whether an IP node is reachable on your internetwork. 


Syntax 


[LOAD] PING 


Using PING 
+ PING sends an ICMP echo request packet to an IP node on your internetwork. If the target node 
receives the packet, it sends back a reply packet. 
+ To select an IP node, enter its hostname or IP address in the Host Name field. 


You can also specify the number of seconds between each packet transmission and the size of 
the packet, in bytes. 


¢ To start sending packets, press Esc. The sending node continues to send request packets and 
collect response time statistics until you press Esc again to exit PING. 


¢ To select additional IP nodes, press Insert. Enter the hostname or IP address of the node in the 
Host Name field. Press Esc to start sending packets. 


1.120 PPPCON 


Purpose 


Use PPPCON to view Point-to-Point Protocol (PPP) interface configuration and statistical 
information. 
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1.121 PPPTRACE 


Purpose 
The PPPTRACE utility enables you to debug PPP data link problems. 


PPPTRACE fully decodes and displays PPP protocol exchanges. You can also examine network 
protocol data that flows through the PPP link in a partially decoded format. 


Because each captured frame is time-stamped to an accuracy of one-tenth of a second, PPPTRACE 
can also provide valuable timing information. 


1.122 PROTECT 


Purpose 


Use at the server console to load NLM™ programs into a protected address space when the 
commands to load the NLM programs are ina .ncf file. Specify the .ncf file as a parameter to the 
command. 


Syntax 


PROTECT filename 





Using PROTECT 


Use this command when you normally use a .ncf file to load multiple modules at once, and you 
want the modules to be loaded into the same protected address space. 


The command creates a protected address space with the same name as the .ncf file and executes 
the .ncf file to load all the modules into the space. 


For example, 


protect grpwise 


creates a protected address space called grpwise and reads grpwise.ncf to load modules into the 
protected space. 





IMPORTANT: Remember that not all modules can run in a protected address space. Some 
modules, such as LAN and disk drivers, MONITOR, and server.exe, must run in the kernel 
address space. For more information, see “Modules Not Allowed in Protected Address Spaces” in 
the NW 6.5 SP8: Server Memory Administration Guide. 
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1.123 PROTECTION 


Purpose 


Use at the server console to display a list of protected address spaces or to add or remove restart 
functionality from an existing address space. 


Restart functionality means that if the protected address space faults, the memory management 
system automatically closes the space, cleans up its resources, restarts the space, and reloads 
modules into it. 


Syntax 





PROTECTION [RESTART | NO RESTART address space] 











Parameter Use to 
no parameter) Display a list of address spaces and the modules loaded into them. 
RESTART address_space Add restart functionality to the designated address space. 


NO RESTART Remove restart functionality from the designated address space. 
address_space 
Using PROTECTION 


When you execute PROTECTION without parameters, the server displays a list of all loaded 
address spaces. Each address space name is followed by a list of the modules loaded into the space, 
with a short description of each module. 


If you add restart functionality to an address space, use the Memory Protection No Restart Interval 
parameter to prevent the address space from repeatedly faulting and then restarting. See “Memory 
Parameters” on page 210. 


1.124 PROTOCOL 


Purpose 
Use at the server console to 


+ View the protocols registered on your NetWare® server 


¢ Register additional protocols and frame types 


Syntax 





PROTOCOL [REGISTER protocol frame id#] 
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Parameter Use to 
(no parameter) Display the protocols registered on your server. 
REGISTER Register a protocol. 


It is only necessary to use PROTOCOL REGISTER in unusual cases, 
such as when using a new media. 


protocol Specify the protocol name. 


frame Specify the name representing the frame type that is to be bound to the 
communication protocol. 


id# Specify the protocol identification number (also called a protocol ID, PID, 
an Ethernet type or E-type, or an SAP). 


This number is a unique, assigned hexadecimal number that tells the 
server how to recognize data coming from a certain network board 
through a designated communication protocol (such as IPX). 


Using PROTOCOL 


+ LAN drivers automatically register IPX; other protocol stacks register themselves. 


¢ For approved protocol loadable modules, consult your reseller. For the protocol name, check 
the documentation that comes with the protocol module. 


+ LAN drivers automatically register a frame type when they are loaded. If the LAN driver 
supports more than one frame type, the frame type is registered when you load the driver with 
that frame type. 


Additional Information 


Topic See 

Binding protocols to a LAN driver Section 1.8, “BIND,” on page 20. 
1.125 PSERVER 

Purpose 


A print server is a software program that monitors and manages printers and print queues. 
PSERVER is the native NetWare print server that takes jobs from a NetWare print queue and directs 
them (via NPRINTER) to the assigned printer. In NetWare 6 software, PSERVER is available only 
as a NetWare Loadable Module (NLM) program that can be loaded on a NetWare server. Beginning 
with NetWare 6 and later releases, Novell's preferred print system is iPrint. 





NOTE: Multiple PSERVER modules cannot run concurrently on the same NetWare server. 





Print server functions can be managed through the NetWare Administrator utility or at the server 
console. 


Utilities 


153 





TIP: This utility is for use with Novell legacy, queue-based print services. iPrint is the default and 
preferred print system in NetWare 6.5. Queue-based printing is fully supported in NetWare 6.5, 
which allows your users to continue printing as they always have until you complete the transition to 
NDPS. 





Syntax at Server Console 











PSERVER .CN=print_server_name.OQU=container.O=container 








Additional Information 


Topic See 

Using PSERVER See Setting Up Print Servers (http://www.novell.com/documentation/lg/ 
nw51/printenu/data/hx6f217r.htmifhx6f217r) in NetWare 5.1 Queue- 
Based Printing. 

Purpose 


Rconag6.nlm is the RConsoleJ Agent. Load this NLM™ at the server console to allow remote 
console access to the server, using RConsoleJ Client. 











Syntax 

LOAD RCONAG6 [ENCRYPT] [-Edigest | password IP port IPX port secure IP port] 

Parameter Use to 

(no parameter) Load RCONAG6 without command line parameters. You will be 
prompted for a password, IP port number, and IPX™ port number, 
Secure IP port number. 

ENCRYPT Encrypt the password and create a sys: systemlldrconag.ncf script 
file if desired. This script file can be used to load RCONAG6 at startup. 
(by inserting Ldrconag.ncf in autoexec.ncf). 

-Edigest Specify an encrypted password (digest) that will be used at the command 
line. 
To use this parameter, you need to load RCONAGE6 using the ENCRYPT 
option. 
This parameter is used in the 1drconag. ncf file (if you create the file 
using the ENCRYPT option). 

password Specify the password you want administrators of the remote server to 


use. 
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Parameter Use to 


IP_port Specify the IP port number that RCONAG6 will listen for RConsoleJ or a 
proxy server on. 


The default is 2034. 
-1 disables IP listening. 
0 allows a dynamically assigned port to be used. 


IPX_port Specify the IPX port number that RCONAG6 will listen for a proxy server 
on. 


The default is 16800. 
-1 disables IPX listening. 
0 allows a dynamically assigned port to be used. 


secure_ IP_port Specify the Secure IP port number that RCONAG6 will listen for 
RConsoleJ on a SSL-based port on. 


The default is 2036. 
-1 disables Secure IP listening. 


0 allows a dynamically assigned port to be used. 


Using RCONAG6 
+ Ifthe target server runs Streams-based SPX™ services, you must load the spxs . n1m before 
loading RCONAGE. See NW 6.5 SP8: Remote Server Management Administration Guide. 


+ Before accessing a target server using RConsoleJ, load RCONAG6 on the server. When you 
load RCONAGE, you establish a password that must be entered when you execute RConsoleJ. 


To optimize security, use an encrypted password when loading RCONAG6. 


To encrypt the password, enter 


RCONAG6 ENCRYPT 





The system prompts for a password. Enter the password. The password is encrypted and two 
options are provided: 


+ (Recommend) Create ldrconag.ncf, containing the script, to load rconag6.nlm with 
the encrypted password. This ensures that your password is in clear text. Additionally, you 
need not remember the password to load rconag6.n1m with the encrypted password. 


¢ Load the rconag6.n1m without creating ldrconag.ncf 


+ If you want to connect to an SPX server using RConsoleJ, you must also create a proxy server 
using rconprxy.nlm. 


+ To make RConsoleJ sessions available whenever you boot the server, enter the following 
command in the autoexec.ncf file. (This assumes you have encrypted the password and 
created the sys:system\ldrconag.ncf file.) 


LDRCONAG 
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Additional Information 


Topic See 

Loading RCONPRXY Section 1.127, “RCONPRXY,” on page 156 

Setting up a target server “Setting Up RConsoleJ” in the NW 6.5 SP8: Remote Server 
Management Administration Guide 

Using RConsoleJ Section 1.128, “RConsoleJ,” on page 157 

1.127 RCONPRXY 

Purpose 


Load at the server console to create an RConsoleJ proxy server on a NetWare® 6 or later server. 
RConsoleJ proxy servers allow RConsoleJ to access target servers using an IPX™ (or IP) 
connection. 


Syntax 


[LOAD] RCONPRXY TCP Port 


Parameter Use to 


(no parameter) Start RCONPRXY without command line parameters. You will be 
prompted for a TCP port number. 


TCP Port This is the TCP port number on which RCONPRXY will listen for 
RConsoleJ. 


The default is 2035. 


0 allows a dynamically assigned port to be used. 


Using RCONPRXY 
+ Use rconprxy.nim to allow RConsoleJ to communicate with an NetWare 6 server IPX-only. 


RCONPRXY creates a proxy server through which RConsoleJ can communicate with the IPX- 
only server. 


+ The proxy server must run both IP and Streams-based SPX™ services. 


To load Streams-based SPX services on the proxy server, use the SPXS NLM™ program. 


Additional Information 


Topic See 


Loading RCONAG6 Section 1.126, “RCONAG6,” on page 154 
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Topic See 


Setting up a proxy server See “Loading the RConsoleJ Proxy Agent on a Proxy Server” in the NW 
6.5 SP8: Remote Server Management Administration Guide 


Using RConsoleJ Section 1.128, “RConsoleJ,” on page 157 
1.128 RConsoleJ 
Purpose 


Use at a workstation or server to remotely control a NetWare® server. 





IMPORTANT: For security reasons, this version of RConsoleJ must be used only inside firewalls. 





Using RConsoleJ 


NetWare 6 provides Java*-based remote console utility (RConsoleJ) that lets you control a NetWare 
server from a workstation and perform the following tasks: 

+ Use console commands as you would at the server console 

+ Use NLM™ programs as you would at the server console (for example, edit.n1m to edit files) 


¢ Send console commands in the server's native language from the RConsoleJ Client using 
Buffer Input 


¢ Control the server from another server using RConsoleJ 
+ Upgrade a NetWare server (text-based Ul only) 
+ Runa Secure Socket Layer (SSL)-based secure session 


You can use the following keystrokes during a remote console session. All other keys function as if 
you were at the server console. 


To Press 

Access the drop-down list of target server console screens Alt+F1 
Cycle to the next target server console screen Alt+F2 
Cycle to the previous target server console screen Alt+F3 


Additional Information 


Topic See 

RConsoleJ NW 6.5 SP8: Remote Server Management Administration Guide 
Using RCONAG6 Section 1.126, “RCONAG6,” on page 154 

Using RCONPRXY Section 1.127, “RCONPRXY,” on page 156 
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1.129 REBUILD 


Purpose 


Use REBUILD to recover corrupted Novell Storage Services (NSS) pools. The REBUILD utility 
salvages the data it finds on your corrupted NSS pool and recovers it. 


NetWare users may be used to using VREPAIR to repair and rebuild NetWare volumes. VREPAIR 
still works for NetWare Traditional volumes, but it does not work on NSS pools. For NSS, you must 
use REBUILD. 


Rebuild verifies and uses the existing leaves of an object tree to rebuild all the other trees in the 
system. The NSS pools that are verified and rebuilt are placed in maintenance mode. This means the 
NSS pool and the volumes on it are unusable until this process is finished, and the pool is 
remounted. 


After running REBUILD, you must run the VERIFY utility. VERIFY accounts for all blocks in the 
system. If errors are found, they are reported to the screen, and the NSS pool is left in maintenance 
mode. Run REBUILD again until no errors are found. If errors are not found, the pool is placed back 
in the active state. You may have to mount the pool and its volumes. 





NOTE: This utility protects against system failures only, not hardware failures. 





Syntax 
To rebuild a single pool, specifying the name, enter 


nss /poolrebuild=pool_name 


Starting and Using REBUILD 


Use REBUILD at the command line. 


NOTE: Always back up your data. If an NSS pool uses several hard disks and one of the hard disks 
becomes corrupted, you must create a new NSS pool, then restore its NSS volumes from backup. 





1 Load NSS. 
2 Rebuild your NSS pool. 
Select one of the following options: 


¢ To rebuild a single pool, specifying the name, enter 


nss /poolrebuild=pool_name 


¢ To rebuild a single pool by selecting from a list of pool names, enter 


nss /poolrebuild 


A list of pools appears. Select the preferred pool. You must enter this command for each 
pool you want to rebuild. 
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+ To rebuild more than one NSS volume at a time, enter 
nss /poolrebuild=pool_name, pool name 


A process runs for each volume up to five NSS volumes. 
Rebuilding a pool can take up to several hours, depending on the size of the pool. 
3 Check the output screen. 


This screen indicates the time elapsed, the time remaining, the total elapsed time, the number of 
objects processed, etc. 


4 Verify your rebuilt NSS pool, by entering 
nss /poolverify=[pool_name] 
If you do not enter the NSS pool name parameter, you will be prompted to select it. 
Additional Information 


Topic See 


NSS volumes “Managing NSS Volumes” in the NW 6.5 SP8: NSS File System 
Administration Guide 


1.130 RECORD 


Purpose 


Use at the server console to record command sequences that you enter at the console over and over. 
The RECORD command creates a temporary batch file on the server. You can then save the 
temporary batch file as an .ncf file or delete it from memory. 


Syntax 

record [action] | [temporary batch file name] 

To Enter 

Begin recording console commands into a record start mylistl 


memory batch file called mylist1 


Close the recording session for the temporary record stop 
batch file named mylist1 


Type the command sequences in the session record type mylistl 
named mylist1 


Remove the recorded session named mylistl record kill mylistl 
from server memory 
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To Enter 


Close the recording session and save it as record stop ncf 
sys:system\mylistl.ncf 


Execute the list of commands in the mylist1 replay mylistl 
session 


Save the MYLIST1 session that has already record save mylistl 
been closed to sys:systemimylistl.ncf. 


Additional Information 


For information, see Section 1.139, “REPLAY,” on page 168. 


1.131 Register Memory 


Purpose 


Use at the server console to configure the operating system to recognize installed memory above the 
amount of memory that is automatically registered. NetWare® 6 can address up to 4 GB. 





IMPORTANT: Use the register memory command only if absolutely necessary. Manually 
registering memory can cause memory fragmentation. Ideally, you should upgrade the system board 
so that NetWare's automatic memory registration will work. 





Before using register memory, try the following: 


+ Review the config.sys or autoexec.bat files to make sure nothing is being loaded on the 
server that prevents memory recognition: sometimes a real mode driver or a memory manager 
stops NetWare from registering memory above 64 MB. 


¢ If your server contains an older network board, such as many ISA and MCA devices, upgrade 
to a newer board. 


+ If you have access to the World Wide Web, search the knowledge base at http:// 
support.novell.com for Register Memory topics. 


Syntax 


register memory start_address amount 


Parameter Use to 

start_address Specify the hexadecimal address where the memory you're adding will 
start. This is the amount of RAM your server currently recognizes and 
addresses. 


This number is usually 16 MB (1000000h); however, the default varies 
depending on the machine type. 


To obtain the start address, use the MEMORY command and convert its 
output to hexadecimal. 
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Parameter Use to 


amount Specify an amount of memory, expressed in hexadecimal, that is installed 
beyond the start address. This number must be divisible by 10h. Up to 1 
GB can be registered at one time. 





NOTE: In the preceding table and in the following sections, the h after the number denotes a 
hexadecimal number. The d denotes a decimal number. 


For example, 1000000h is 1 million in hexadecimal, and 1000000d is 1 million in decimal. 


The hexadecimal numbers A through F correspond to the decimal numbers 10 through 15, 
respectively. 





Using Register Memory 


+ NetWare registers all memory that it recognizes according to bus type. On an ISA bus, NetWare 
recognizes up to 16 MB. On an EISA or MCA bus, NetWare recognizes all of the memory that 
is present. On a computer with a Peripheral Component Interconnect (PCI) bus, NetWare 6 or 
later recognizes up to 4 GB. 


¢ To have the additional memory registered automatically when the server boots, add the 
register memory line to the startup.ncf file. 





IMPORTANT: Place the register memory command before the command to load disk 
drivers in the startup.ncf file so that the registered memory will be available to the sys: 
volume. 


Failure to register memory before volume Sys is mounted can result in error messages 
indicating that the cache memory allocator is out of available memory, or that there is 
insufficient memory to mount volumes. 





+ Ifthe memory does not register, check for the following possible errors: 
+ An incorrect hexadecimal value was specified for start address or amount. 


+ The amount value exceeds the total installed memory. Use the setup or reference diskette 
that came with the computer to determine the total amount of installed memory. 





NOTE: You must avoid memory address conflicts. A conflict occurs if an adapter board uses 
16- or 24-bit DMA or Bus-Master DMA. 


To resolve this conflict, upgrade to 32-bit bus adapters or use drivers that are modified and 
certified to compensate for memory-addressing limitations. Or use the machine's configuration 
program to move system memory around the adapter 1f the program allows. 





+ In some cases, the ISA (16-bit) host adapter driver must be loaded in memory below 16 MB. To 
do so, add the following to the startup.ncf file: 


load disk driver 


register memory amount of memory to add 


For more information, consult the driver documentation. 
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Amount of Memory 


The following table lists common start address and amount values for standard computers. 


In the table, total memory = start address + amount of memory to add. 


Total Memory Start Address Amount of Memory to Add 
20 MB 16 MB = 1000000h 4 MB = 400000h 

24 MB 16 MB = 1000000h 8 MB = 800000h 

28 MB 16 MB = 1000000h 12 MB = CO0000h 

32 MB 16 MB = 1000000h 16 MB = 1000000h 
36 MB 16 MB = 1000000h 20 MB = 1400000h 
40 MB 16 MB = 1000000h 24 MB = 1800000h 
64 MB 16 MB = 1000000h 48 MB = 3000000h 
112 MB 16 MB = 1000000h 96 MB = 6000000h 
128 MB 16 MB = 1000000h 112 MB = 7000000h 
256 MB 16 MB = 1000000h 240 MB = FO00000h 
400 MB 16 MB = 1000000h 384 MB = 18000000h 


1 GB (1000 MB) 16 MB = 1000000h 984 MB = 3D800000h 


3 GB (3000 MB) 16 MB = 1000000h 2984 MB = BA800000h 


3 GB (3000 MB) 64 MB = 4000000h 2936 MB = B7800000h 


Register memory requires that the amount of memory to be registered is stated in hexadecimal 
format. If you are adding an amount of memory that is not in the preceding table, then you need to 
calculate the amount. 


Calculating the Amount of Memory 
The following figure illustrates how to calculate the amount of memory you are adding: 


Figure 1-8 Calculating the Amount of Memory You Are Adding 









1 


Number of Number of | 


MB memory Į 
to add 





bytes in oo bytes in 
decimal | hexadecimal 





1. Start with the amount of memory you are adding stated in decimal MB. 


Obtain this number from the documentation that came with the memory you are adding. 


2. Convert the memory value from MB to bytes. 


NOTE: A megabyte of memory is more than a million bytes. One megabyte equals 1,048,576 
bytes in decimal. 
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3. Convert the number of bytes from decimal to hexadecimal notation. 


To do this calculation, you can either use a calculator that converts decimal numbers to 
hexadecimal, or you can convert manually. 


For example, 1 megabyte = 1,048,576d, which is the same as 100000h. 
So 1,048,576 bytes in decimal equals 100000 in hexadecimal. 


To convert manually, consult a specialized manual. 


Examples 


+ To add 4 MB of memory above 16 MB, type 


register memory 1000000 400000 
+ To add 24 MB of memory above 16 MB, type 


register memory 1000000 1800000 


Additional Information 


Topic 


Editing the startup.ncf file 


Displaying the total amount of memory 
the server is addressing 


1.132 REINITIALIZE SYSTEM 


Purpose 


Use at the server console to enable configuration changes made since the commands in the 
netinfo.cfg file were executed. 


Syntax 


“Using Server Batch Files” in the NW 6.5 SP8: Server 
Operating SystemAdministration Guide 


Section 1.90, “Memory,” on page 98 





REINITIALIZE 








SYSTE 
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Using REINITIALIZE SYSTEM 

















* REINITIALIZE SYSTEM compares the current netinfo.cfg file with the previous one, which 
became effective the last time you ran the INITIALIZE SYSTEM or REINITIALIZE 
SYSTEM command. If REINITIALIZE SYSTEM finds any new commands in the current 
netinfo.cfg file, it executes them. 


+ REINITIALIZE SYSTEM also informs any Simple Network Management Protocol (SNMP)- 
registered NLM™ file that it is executing. This is a call-back mechanism that enables NLM 
files that store configuration information outside the net info.cfg file to know that changes to 
the configuration have taken place. 


Limitations of REINITIALIZE SYSTEM 


+ REINITIALIZE SYSTEM unloads any NLM affected by a configuration change. If 
REINITIALIZE SYSTEM cannot unload the NLM because of interdependencies with other 
modules, the configuration change will not take effect. Additionally, not all NLM files register 
with SNMP for notification of REINITIALIZE SYSTEM. 


+ When you create a new configuration or delete an existing configuration, REINITIALIZE 
SYSTEM recognizes the change. However, REINITIALIZE SYTEM may not recognize 
changes to an already configured NLM that involve more than loading, unloading, binding, or 
unbinding protocol stacks. 





IMPORTANT: If you are changing an existing configuration, the most effective way to ensure 
the changes are recognized is to bring down the server. Alternatively, if you know which NLM 
files have been changed by your modifications, you can unload them, then execute 
REINITIALIZE SYSTEM. 





Additional Information 


Topic See 
netinfo.cfg file Section 1.65, “INETCFG,” on page 71 
INITIALIZE SYSTEM Section 1.66, “INITIALIZE SYSTEM,” on page 73 


1.133 REMIRROR PARTITION 


Purpose 
Use at the server console to start the remirroring of a logical partition. 


Because the server remirrors partitions automatically, you should use REMIRROR PARTITION 
only if you have stopped remirroring by using the ABORT REMIRROR command or something has 
caused your server to cease remirroring. 


Remirror Partition can be used on any NetWare mirror, regardless of type as long as all the partition 
types in the mirror match. This includes NSS, TRAD, SBD, and ISCSI devices and any other 
NetWare partition types that are mirrored. 
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Syntax 


REMIRROR PARTITION logical partition number 





Parameter Use to 
number Specify the number of the logical partition you want to start remirroring. 
Example 


To start remirroring for logical partition 0x4, enter 


REMIRROR PARTITION 4 





Additional Information 


Topic See 

Stopping remirroring Section 1.1, “ABORT REMIRROR,” on page 11 

Mirroring and unmirroring (For NSS volumes on NetWare) “Managing NSS Software RAID 
partitions Devices” in the NW 6.5 SP8: NSS File System Administration Guide 


(For Traditional volumes) “Using Software RAID1 Devices for Data Fault 
Tolerance” in the NW6.5 SP8: Traditional File System Administration 
Guide 


1.134 REMOVE NETWORK ADAPTER 


Purpose 


Use at the server console to unload one LAN driver when the LAN driver has been loaded multiple 
times to support multiple boards. 




















Syntax 

REMOVE NETWORK ADAPTER filename, [board instance] 

Parameter Use to 

filename Specify the LAN driver name, such as ne2000.lan 

board_instance Specify the instance number of the board if there is more than one board 


of the same type in the server. 


Find the instance number in MONITOR by selecting LAN/WAN Drivers 
and highlighting the driver name. The information window at the top of 
the screen displays information about the driver, including the Board 
Instance Number. 


Utilities 165 


Using REMOVE NETWORK ADAPTER 


If there is only one instance of the network board in the server, you do not need to use REMOVE 
NETWORK ADAPTER. You can simply unload the LAN driver using the UNLOAD command. 
Unloading the LAN driver releases the memory resources used by the board and driver. 


Example 








REMOVE NETWORK ADAPTER NE2000, 2 























1.135 REMOVE NETWORK INTERFACE 


Purpose 


Use at the System Console scree to unload one frame type when there are multiple frame types 
loaded with one LAN driver. Each instance of one frame type loaded with one LAN driver is called 
a logical board. 


When you use REMOVE NETWORK INTERFACE to unload a frame type, the associated LAN 
driver with its other frame types remains loaded and active. 


Syntax 








REMOVE NETWORK INTERFACE board_number | board_name 























Parameter Use to 
board_number Specify the logical board number. Find the logical board number in 
MONITOR by selecting LAN/WAN Drivers and highlighting the driver 


name. The information window at the top of the screen displays 
information about the driver, including Logical Board Number. 


board_name Specify the logical board name. A name can be assigned to a logical 
board when the board is loaded using the LOAD command. If no name 
was assigned to the board, use the logical board number. 


1.136 Remove Storage Adapter 


Purpose 


Use at the server console to remove one instance of a storage driver. 


Syntax 


remove storage adapter an 
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Parameter Use to 
An Specify the driver instance you want to remove. 


Find the number by entering the list storage adapters command 
at the console. The An number is enclosed in square brackets to the left 
of the storage adapter name. For example: 


[V312-A0] ADAPTEC PCI Host Adapter Module 


To unload the instance of the driver in the example, you would enter the 
following: 


remove storage adapter a0 


Using REMOVE STORAGE ADAPTER 
If only one instance of the driver is currently loaded, the entire driver is unloaded. 


If multiple instances of the driver are loaded, only the selected instance is unloaded. 


1.137 Removemodule 


Purpose 


Use at the System Console prompt to remove modules that are preloaded by the startup.ncf file 
or modules that were loaded using the load -s command. 


Preloading modules is required to avoid a fatal loss of access to essential driver files during a time 
period in the boot process when access to the FAT (DOS) partition containing the files is not 
possible. This period begins when the first driver is activated and ends when the partition is made 
available through NetWare drivers instead of Real Mode (BIOS/DOS) drivers. 


If you have tested serveral load switches for a new driver and want only one to be active, remove it 
from the list and then reload and activate the driver. 


Syntax 


removemodule = all|module_name 


For example: 


removemodule idecd.cdm 





Parameter Use to 
all Remove all modules that have been preloaded. 
module_name Specify the name of a preloaded module that you want to remove. 
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Additional Information 


For related information, see Section 1.2, “Activatemodule,” on page 12. 


1.138 REPLACE 


Purpose 


Use at the server console to unload and reload a specific module in one step. Entering this command 
unloads the module and reloads it using the current search path order. 


To view the ordering of current search paths on the server, enter search at the server console. 


Syntax 





replace module_name 


For example, if you have a new monitor nlm program that you have copied to sys: system, rather 
than entering 


unload monitor 
load monitor 
you only need to enter 


replace monitor 


1.139 REPLAY 


Purpose 


Use at the server console, to execute a list of commands that were recorded in and saved in a session 
using the RECORD command. 


Syntax 
replay [session_name] 
For example, if the session was named mylist1, enter 


replay mylistl 


Additional Information 


For information, see Section 1.130, “RECORD,” on page 159. 


1.140 RESET ENVIRONMENT 


Purpose 


Use at the server console to reset server parameters that have been modified to their default values. 
You can reset all modified parameters or you can confirm only those resets that you want. 
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Syntax 





RESET ENVIRONMENT 

















Using RESET ENVIRONMENT 


RESET ENVIRONMENT lists the first server parameter with the option of resetting the current 
value to the default value or of retaining the modified value. You can also reset all parameters that 
have modified settings to their default values, or else quit the utility. 


The following example illustrates part of the command display: 


Reset variable TIMESYNC Hardware Clock 
(Y)es, (N)o, (A)11, (Q)uit ? 





Additional Information 


Topic See 
List server parameters with current settings Section 1.40, “Display Environment,” on page 42 
List server parameters with modified settings Section 1.44, “DISPLAY MODIFIED 


ENVIRONMENT,” on page 48 


Print server parameters with current settings to a Section 1.94, “MONITOR,” on page 102 


file. 
MONITOR Available Options > Server Parameters 


1.141 RESET NETWORK ADAPTER 


Purpose 


Use at the server console to reset a network adapter manually. 





WARNING: Resetting a network adapter stops whatever work the adapter is doing and resets it to a 
clean state. 





Syntax 





RESET NETWORK ADAPTER filename, [board_instance] 

















Parameter Use to 


filename Specify the LAN driver name, such as ne2000.1an 
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Parameter Use to 


board_instance Specify the instance number of the board if there is more than one board 
of the same type in the server. 


Find the instance number in MONITOR by selecting LAN/WAN Drivers 
and highlighting the driver name. The information window at the top of 
the screen displays information about the driver, including Board 
Instance Number. 


Using RESET NETWORK ADAPTER 


You might want to reset an adapter manually if you suspect a problem with the hardware. Resetting 
the adapter also resets the logical boards associated with the adapter. 


Network adapters reset themselves automatically if something goes wrong. About one reset a day is 
normal. A great number of resets, such as one reset a minute, usually indicates a hardware problem. 


Resets are included in the LAN statistics displayed in MONITOR. Select LAN/WAN Drivers and 
highlight a driver name. Press Tab to expand the information window at the top of the screen. Look 
for Adapter Resets in the Generic Counters section of the screen. 


Example 








RESET NETWORK ADAPTER NE2000, 2 


1.142 RESET NETWORK INTERFACE 


Purpose 























Use at the server console to restart a logical board that has been shut down using the SHUTDOWN 
NETWORK INTERFACE command. See Section 1.156, “SHUTDOWN NETWORK 
INTERFACE,” on page 252. (A logical board is an instance of one frame type associated with one 
LAN driver.) 


RESET NETWORK INTERFACE restarts the logical board without requiring you to reload and 
bind the LAN driver. 





NOTE: Resetting the logical board does not reset the adapter. 





Syntax 








RESET NETWORK INTERFACE board number | board_name 























Parameter Use to 


board_number Specify the logical board number. Find the logical board number in 
MONITOR by selecting LAN/WAN Drivers and highlighting the driver 
name. The information window at the top of the screen displays 
information about the driver, including Logical Board Number. 
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Parameter Use to 
board_name Specify the logical board name. A name can be assigned to a logical 


board when the board is loaded using the LOAD command. If no name 
was assigned to the board, use the logical board number. 


1.143 RESET ROUTER 


Purpose 


Use at the server console to reset the router table in the server if the table becomes inaccurate or 
corrupted. 


Syntax 





RESET ROUTER 














Using RESET ROUTER 


+ If several servers or bridges go down, packets sent to or through their routers are lost. Use 
RESET ROUTER to update router tables on active servers. 


+ Normally, the router updates its tables every minute. This command updates the router table 
immediately. 


+ RESET ROUTER is for IPX only. For TCP/IP, see Section 1.147, “ROUTECON,” on 
page 178. 


1.144 Restart Server 


Purpose 


Use at the server console to bring down the server and then to restart it immediately after. 


Syntax 


restart server [-parameter] 


Parameter Use to 
(no parameter) Restart the server and invoke all .ncf files. 
-ns Restart the server without invoking the startup.ncf file. 


For example, type: 
restart server -ns 


-na Restart the server without invoking the autoexec. ncf file. 
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Using Restart Server 


Restart server is useful when troubleshooting requires that you bring down the server frequently. 
(If you need to bring the server down to reboot it with new parameters, use Section 1.46, “Down,” 
on page 50.) 


Additional Information 


Topic See 

Restarting the server from DOS Section 1.153, “Server,” on page 186 
1.145 RIGHTS 

Purpose 


Use at a workstation to do the following: 


+ View or modify user or group rights for files 


¢ View or modify user or group rights for directories and volumes 


RIGHTS is a client-side application, not a server-side application. Install the Novell Client for 
Windows on your workstation, then use the Novell Map Network Drive option in the client menu to 
map a local drive letter to the sys: /public directory. Open a DOS Command Prompt window, cd 
to the mapped drive, then issue the rights command from the command line. 





Syntax 

RIGHTS path [[ + | - ] rights] [/option...] [/? | /VER] 

Parameter Use to 

path Specify the path to the file, directory, or volume you want to modify or 
view rights to (you must always specify a path). 

+|- Add or delete the specified rights. See “Using RIGHTS” on page 173. 

rights Specify one or more file or directory rights. See “Rights” on page 173. 

loption Replace option with any available option. 

1? View online help. All other parameters are ignored when /? is used. 

IVER View the version number of the utility and the list of files it uses to 
execute. All other parameters are ignored when /VER is used. 

Option Use to 

IC Scroll continuously through output. 
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Option 
IF 
A 


/NAME=username 


IS 
IT 


Rights 


Use to 


View the Inherited Rights Filter (IRF). 


View the trustee and group rights that created the inherited rights, and 
view where the inherited rights came from. 


View or modify rights for the user or group listed. Replace username with 
the name of the user or group whose rights you want to view or modify. 


View or modify subdirectories below the current level. 


View trustee assignments in a directory. 


The following table lists the rights, the letter to use for each right, and what the right is used for. 


Right 
Supervisor 
Read 
Write 
Create 
Erase 
Modify 

File Scan 


Access Control 


No Rights 
Remove 


All 


Using RIGHTS 


Letter 


Use to 

Grant all rights to the file or directory. 

Open and read files in the directory. 

Open and write to files in the directory. 

Create files and subdirectories. 

Erase files and directories. 

Rename files and directories, and change file attributes. 

View and search on file and directory names in the file system structure. 


Add and remove trustees and change trustee rights to files and 
directories. 


Remove all rights. 
Remove the user or group as a trustee of the specified file or directory. 


Add All rights except Supervisor. 


¢ Ifyou use + (plus) to add rights, the rights you list are added to the existing rights. 


¢ Ifyou use - (minus) to remove rights, the rights you list are deleted from the existing rights. 


¢ Ifyou add and delete rights in the same command, group all added rights together and all 


deleted rights together. 


¢ Ifyou list rights without using + or -, the rights you list replace the existing rights. 


+ You must always specify a path. You can use a period (.) to represent your current directory. 


+ You can use wildcard characters. 
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Examples 


¢ To set the trustee rights in the current directory for user JANICE to Read, Write, and File Scan, 
type 





RIGHTS . R W F /NAME=JANICE 











+ To remove user ERNESTO from alice/sys:users, type 





RIGHTS ALICE/SYS:USERS REM /NAME=ERNESTO 























+ To see where user PATRICK's inherited rights came from for sys: users/home, type 





RIGHTS SYS:USERS/HOME /NAME=PATRICK /I 














1.146 ROUTE 


Purpose 


Use at the server console on a token ring cabling system to pass frames (packets) from NetWare® 
through IBM*-compatible source route bridges. 


ROUTE enables the operating system to 


+ Keep track of the source routing information in the frames 


¢ Configure the source routing information in the frames according to the parameters with which 
ROUTE is loaded 


NOTE: You must load the token ring LAN driver before you load ROUTE. 





ROUTE and most ROUTE parameters can also be configured using the INETCFG utility. See 
“Configuring Source Route End Station Parameters with INETCFG” on page 177. 


Syntax 


[LOAD] [path] ROUTE [BOARD=number] [NAME=board_name] [DEF|GBR|MBR] 
[TIME=number] [RSP=AR|NR] [CLEAR] | [REMOVE=number] [XTX=number] [UNLOAD 
[BOARD=number]] 


Parameter Use to 


path Specify the path to route. n1m if you moved it from the default directory. 
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Parameter 


BOARD=number 


NAME=board_name 
DEF (Default) 


GBR (General Broadcast 
frames) 


MBR (Multicast Broadcast 
frames) 


TIME=number 


Use to 


Specify the board you want to change parameters on or load ROUTE for. 
Replace number with the board number. 


If you don't specify a board number, the default is board number 1, or the 
board name specified in the NAME parameter. 


The system numbers the boards, using 1 for the first driver loaded. 
(Check the order in the autoexec.ncf file.) 


Specify the board name. 


Specify that all Unknown Unicast frames are to be sent as All Routes 
Broadcast frames. 


If DEF is specified, all frames with addresses not in the server's Source 
Routing table are forwarded as All Routes Broadcast frames. 


If DEF is not specified, all frames with addresses not in the server's 
Source Routing table are forwarded as Single Route Broadcast frames. 


If ROUTE is already loaded with the DEF parameter, reloading ROUTE 
with DEF sends all Unknown Unicast frames as All Routes Broadcast 
frames. 


Specify that all General Broadcast frames are to be sent as All Routes 
Broadcast frames. 


If this parameter is not specified when ROUTE is loaded, all General 
Broadcast frames are broadcast as Single Route Broadcast frames. 


If ROUTE is already loaded with the GBR parameter, reloading ROUTE 
with GBR broadcasts all General Broadcast frames as All Routes 
Broadcast frames. 


Specify that all Multicast frames are to be sent as All Routes Broadcast 
frames. 


If the parameter is not specified when ROUTE is loaded, all Multicast 
frames are broadcast as Single Route Broadcast frames. 


If ROUTE is already loaded with the MBR parameter, reloading ROUTE 
with MBR broadcasts all Multicast frames as All Routes Broadcast 
frames. 


Specify how often the Source Routing table should be updated. 


Replace number with a value from 3 to 255 seconds. The default is 10 
seconds. 


This parameter forces the table to be updated with a new route if the 
route isn't used during the specified time. 


It enables ROUTE to determine alternate routes dynamically when an 
IBM bridge goes down. 
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Parameter 


RSP=value (Respond) 


CLEAR 


REMOVE=number 


XTX=number 


UNLOAD [BOARD=number] 


Using ROUTE 


Use to 


Specify how the server should respond to a broadcast request. 
Replace value with one of the following: 


NR: Specifies that all Broadcast Requests are to be responded to 
directly; a Broadcast Response isn't required. 


AR (the default): Specifies that all Broadcast Requests are to be 
responded to with an All Routes Broadcast frame. 


Clear the Source Routing table. Use when an IBM bridge has gone down 
and an alternate route is available. 


CLEAR forces a dynamic rebuilding of the table by sending a default 
frame to each specific node in the network. 


Use CLEAR to completely clear the Source Routing table, or use 
REMOVE to clear only one node address from the Source Routing table. 


Remove a specified node address from the server's Source Routing 
table. 


Replace number with a 12-digit (6-byte) hexadecimal number. 


If you enter fewer than nine digits, ROUTE prefixes the address with 
4000 in hexadecimal. 


For example, REMOVE=2 becomes REMOVE=400000000002. 


Use REMOVE when a bridge has gone down. When you remove the 
node from the Source Routing table, you force the server to determine 
an alternate route. 


Specify the number of times to transmit on a timed-out route, using the 
old route. 


Replace number with a value between 00 and 255 seconds. The default 
is 02 times. 


Use to remove source routing support for a specified board. 
If you don't specify a board number, the default is 1. 
Example: ?remove this 

LOAD ROUTE UNLOAD BOARD=2 


Note: This parameter does not unload route.n1m, but disables source 
routing only for the board that you specify. 


+ No parameters are required. However, you can load ROUTE a second time with a specified 
parameter to change the configuration. 


+ Most of the parameters have default values that should work with simple configurations for 


IBM bridges. 


If you have parallel IBM bridges, you can change some of the parameters to reduce traffic on 


some of the paths. 
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+ As frames pass through an IBM bridge, source routing information is added to the frame header 
at the Media Access Control (MAC) layer. The operating system's bridging is done above this 
layer. 


+ ROUTE can be loaded reentrantly. 


¢ If you have two token ring boards in the server, load ROUTE twice. The second time you 
load it, use the BOARD or NAME parameter to specify a particular board. 


+ To change the configuration, load ROUTE with the parameter that needs to be changed. 


Configuring Source Route End Station Parameters with INETCFG 
You can use INETCFG to load ROUTE and configure many source route end station parameters. 
To use INETCFG: 

1 Load INETCFG. 


2 Select Internetwork Configuration > Boards to load a token-ring board. 


3 Return to the Internetwork Configuration menu and use the Protocols option to enable Source 
Route End Station. 


4 Return to the Internetwork Configuration menu and select Bindings. 
A list of bindings appears. 

5 Select an existing binding or press Insert to add a new binding. 
A list of enabled protocols appears. 

6 Select Source Route End Station. 
A list of boards is displayed. 

7 Select the token ring board you configured with the Boards option. 
The Attach Source Route End Station to an Interface menu appears. 


The Source Route End Station parameters are listed in the following table. 


Table 1-2 Source Route End Station Parameters 


Parameter Use to 
Interface Name (same as View the name of the interface to which the end station source 
NAME=board_name router is bound. This field is read-only. 


command line parameter) 
Frame Type View or modify the source route end station list of frame types. 


Press Enter to see the list. Press Insert to select a frame type. Press 
Delete to remove a frame type. 


Send Frames with Unknown Specify the type of explorer frame the end station source router 


Address (same as DEF sends to an unknown node address. 
[Default] command line i 
parameter) Options: Single Route Explorer Frame, All Routes Explorer Frame 


Default: Single Route Explorer Frame 
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Parameter 


Send Broadcast Frames 
(same as GBR command line 
parameter) 


Send Multicast Frames 
(same as MBR command line 
parameter) 


Respond to Broadcast 
Request (same as RSP 
command line parameter) 


Route Update Interval (same 
as TIME=number command 
line parameter) 


Use to 


Specify the type of explorer frame the end station source router 
sends to a broadcast destination address. 


Options: Single Route Explorer Frame, All Routes Explorer Frame 
Default: Single Route Explorer Frame 


Specify the type of explorer frame the end station source router 
sends to a multicast, group, or functional address. 


Options: Single Route Explorer Frame, All Routes Explorer Frame 
Default: Single Route Explorer Frame 


Specify how the end station source router responds to a single route 
explorer frame. 


Options: Specifically Routed Frame, All Routes Explorer Frame 
Default: All Routes Explorer Frame 


Specify the minimum delay in seconds before the end station source 
router updates the route for a given node. 


Range: 0 to 65,535 seconds (O=infinite) 
Default: 10 





NOTE: To remove source route bridge support for the specified board, disable the binding. 





Additional Information 


Topic See 


INETCFG Section 1.65, “INETCFG,” on page 71 


Source routing and broadcast /BM Token-Ring Network Architecture Reference 


frames 


1.147 ROUTECON 


Purpose 


Use at the server console to manipulate the routing tables manually. 


Syntax 


routecon [-h] 


routecon displays the syntax for the utility. 


-h displays detailed help for the utility. 
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routecon [-n] monitor 


Continuously reports any changes to the routing table. 


routecon [-n] flush 


Removes all routes. 


routecon [-nv] command [-net|-host] destination gateway [optional modifier] 


Options/Commands/Optional Modifiers Use To 


Options 

-n Skip DNS lookup. 

-V Print additional details, if any. 

-net Force the destination to be interpreted as a network. 

-host Force the destination to be interpreted as a host. 

destination Specify the destination host or network 

gateway Specify the next-hop intermediary via which packets should be 
routed 

Commands 

add Add a route. 

delete Delete a route. 

change Change aspects of a route (such as its gateway). 

get Look up and display the route for a destination. 

Optional Modifier 

-netmask netmask Manually add a subnet route with the netmask different from 


the default mask. 


1.148 SCAN ALL 


Purpose 


Use at the server console to scan all LUNs of all SCSI adapters in the server or all LUNs associated 
with a designated SCSI adapter. 
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IMPORTANT: SCAN ALL forces a scan and takes an order of magnitude longer to execute than 
SCAN FOR NEW DEVICES does. SCAN ALL should be used only when you know that there is an 
undetected device on a LUN other than LUNO. 





Syntax 


SCAN ALL An 


Parameter 


(no parameter) 


An 


Using SCAN ALL 


Use to 


Scan all LUNs of all SCSI adapters in the server. 
Specify the SCSI adapter you want to scan. 


Find the An number by entering the LIST STORAGE ADAPTERS 
command at the console. The An number is enclosed in square brackets 
to the left of the storage adapter name, for example: 


[V312-A0] ADAPTEC PCI Host Adapter Module 


To scan all LUNs associated with the adapter in the example, you would 
enter: 


SCAN ALL AO 


Several utilities perform much the same operation, but they each differ in some respects. 


+ LIST STORAGE ADAPTERS displays a list of registered storage adapters and the devices 
they drive. The information is read from the Media Manager database. 


+ LIST DEVICES forces a scan for devices , displays the return list of storage devices, and 
registers any new devices with the Media Manager database. This command does not simply 


read the database. 


+ SCAN FOR NEW DEVICES forces a scan on LUNO of SCSI adapters and registers new 
devices with the Media Manager so that they are available to the operating system. This 
command scans only SCSI devices. 


Additional Information 


Topic 


See 


Reading the Media Manager database and Section 1.80, “LIST STORAGE ADAPTERS,” on 
displaying a list of registered storage devices and page 85 


controllers 


Scanning devices and registering new devices with Section 1.79, “LIST DEVICES,” on page 83 


Media Manager 


Scanning for new SCSI devices and registering Section 1.149, “SCAN FOR NEW DEVICES,” on 


them with the Media Manager 
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page 181 


Topic See 

Determining the operating status of a storage “Activating and Deactivating a Hard Disk” in the 
device NW6.5 SP8: Server Disks and Storage Devices 
Storage device drivers “Drivers for Host Adapters and Storage Devices” in 


the NW6.5 SP8: Server Disks and Storage Devices 


1.149 SCAN FOR NEW DEVICES 


Purpose 


Use at the server console to force a scan on LUNO of SCSI adapters and to register new devices with 
the Media Manager so that they are available to the operating system. 


Syntax 

















SCAN FOR NEW DEVICES 


Using SCAN FOR NEW DEVICES 


+ 


Use this utility if you add new devices after you boot your server and the devices do not then 
appear with the LIST DEVICES command. 


If devices have been added, but the drivers aren't loaded in startup.ncf, use SCAN FOR 
NEW DEVICES after loading the drivers to register the devices with the system. 


After you boot the server, if NetWare® detects new devices, SCAN FOR NEW DEVICES 
registers the devices with the operating system. It does not return a message to the screen. 


This command scans only LUNO of SCSI adapters. To scan all LUNs of SCSI adapters, use 
SCAN ALL. However, SCAN ALL should be used only when you know that there is an 
undetected device on a LUN other than LUNO. SCAN ALL may take far more time for to 
execute than does SCAN FOR NEW DEVICES. See Section 1.148, “SCAN ALL,” on 
page 179. 


SCAN FOR NEW DEVICES does not produce any output. 


If you remove a Hot Plug mirrored disk without bringing down the server, you must execute 
SCAN FOR NEW DEVICES as soon as you remove the disk. This lets the system know that 
the remaining disk in the mirrored pair is no longer synchronized with a mirrored partner. If 
you unmirror the disk before removing it, you do not need to run SCAN FOR NEW DEVICES. 


Additional Information 

Topic See 

Read the Media Manager database and display a list Section 1.80, “LIST STORAGE ADAPTERS,” on 
of registered storage devices and controllers page 85 

Scan devices and register new devices with Media Section 1.79, “LIST DEVICES,” on page 83 


Manager 
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Topic 


See 


Scan for all SCSI devices or a specified SCSI device Section 1.148, “SCAN ALL,” on page 179 
and register new devices with the Media Manager. 


Storage device drivers 


“Drivers for Host Adapters and Storage Devices” 
in the NW6.5 SP8: Server Disks and Storage 
Devices 


Determine the operating status of a storage device “Activating and Deactivating a Hard Disk” in the 


NW6.5 SP8: Server Disks and Storage Devices 


1.150 SCRSAVER 


Purpose 


Use to lock the server console and to activate a screen saver for the console display. 





NOTE: The screen saver and the console-locking features were formerly part of MONITOR. 
Separating them from monitor .nlm allows the new utility to protect the console by using the 
stronger security of eDirectory authentication. 





Syntax 





SCRSAVER [option][;option][;option] [...] 


When SCRSAVER is loaded, you can use any of the following command options as console 


commands. 


Command options 


(no parameters) 


ACTIVATE 


AUTO CLEAR DELAY 


DELAY 


DISABLE 


DISABLE AUTO CLEAR 
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Use to 


Default to SCRSAVER AUTO CLEAR DELAY=60; DELAY=600; 
ENABLE; ENABLE AUTO CLEAR; ENABLE LOCK. 


Override the delay interval and activate the screen saver immediately. 


ACTIVATE also overrides both DISABLE and ENABLE modes. This 
means that if you enter ACTIVATE when the screen saver has been 
disabled, the DISABLE mode is changed to ENABLE so that the screen 
saver can appear. 


Set the number of seconds to wait before clearing the unlock dialog box. 
The range is 1 to 300 and the default is 60, or one minute. 


Set the number of seconds to wait before activating the screen saver. 
The range is 1 to 7000 and the default is 600, or 10 minutes. 


Disable the screen saver, thereby preventing it from activating and 
saving the console display. 


Disable the automatic clearing of the unlock dialog box. When this 
command is executed, the unlock dialog box remains on the screen until 
itis cleared by user input. 


Command options 


DISABLE LOCK 


DISABLE USERNAME AUTO 
CLEAR 


ENABLE 


ENABLE AUTO CLEAR 


ENABLE LOCK 


ENABLE USERNAME AUTO 
CLEAR 


HELP 
NO PASSWORD 


STATUS 


Using SCRSAVER 


Use to 


Disable the console lock. When the locking feature is disabled, you can 
retrieve the console display without a username or password simply by 
pressing any key. 


Allows the server console to be unlocked with only a password, rather 
than username and password. 


Enable the screen saver. When enabled, the screen saver displays after 
the keyboard has been inactive for the number of seconds specified in 
the DELAY command option. 


Enable the automatic clearing of the unlock dialog box after the number 
of seconds of keyboard inactivity specified in the AUTO CLEAR DELAY 
command option 


Enable the console locking feature. When enabled, the screen saver 
requires the username and password before restoring the console 
display. The user object must have appropriate rights 


Requires both the username and password to unlock the server console. 


Display information about command options and their use. 


Unlock the console without requiring a password in the event that 
eDirectory becomes unavailable. 


You must set this option when you load SCRSAVER. Otherwise, the 
console cannot be unlocked when eDirectory is unavailable. 


Display the current status of screen saver features and command 
options. 


When the screen saver is displayed, a snake-like figure—one for each online processor—appears on 
the blank console screen. The snake for processor 0 is red and the snake for processor 1, blue, etc. 
The snakes move randomly on the screen, and as processor utilization increases, the snakes move 


faster and their tails lengthen. 


When scrsaver.nlm is loaded, the server console can be in one of three states. 


+ Active. The console is active—you can enter console commands and monitor server activity. 


+ Screen Saver. The console can be locked or unlocked. 


If the console is not locked, the screen saver appears by default after 10 minutes of inactivity. 
To retrieve the console display, press any key. 


If the console is locked, the screen saver appears by default after one minute of inactivity. To 
retrieve the console display, the console must first be unlocked. 


+ Verifying. SCRSAVER verifies rights to the console through eDirectory authentication. 
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To unlock the console, you must supply an eDirectory username and password. The eDirectory user 
must be either of the following. 


+ A trustee of the Server object having the Write right to the “access control list” (ACL) property 
of the Server object 


+ A Console operator or a member of a group assigned as “console operator,” with the user or 
group being a trustee of the Server object with at least the Read right to the [All Attributes 
Rights] property of the Server object 


The chance of eDirectory™ becoming unavailable is very slim, but you can load SCRSAVER with 
the NO PASSWORD option to ensure that you can (if necessary) unlock the console without a 
password. (Of course, a password would still be required when eDirectory was available.) 


For example, you might decide to run DSREPAIR in manual mode. In such a case, the eDirectory 
database would be locked until there was manual intervention. If SCRSAVER were also active and 
locked the console on schedule, you would have a deadlock situation—unlocking the console would 
be dependent on eDirectory authentication—and making eDirectory available for authentication 
would be dependent on unlocking the console. 


If you first load SCRSAVER with NO PASSWORD, you avoid having to power off the machine or 
break into the debugger to exit NetWare®. To ensure that SCRSAVER is loaded when the server is 
started, you can use place SCRSAVER in the autoexec.ncf file. 


1.151 SEARCH 


Purpose 
Use at the server console to 


+ Tell the server where to look for loadable module files and .ncf files 
+ Add other search paths or delete current search paths 


¢ View the current search paths for the operating system 


Syntax 





SEARCH [ADD [number] path] 


or 





SEARCH DEL [number] 











Parameter Use to 
(no parameter) View the current search paths. 
number Specify the number of the search drive you want to add or remove. 
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Parameter Use to 


path Specify the complete path of the directory you want searched. (The 
default is sys: system.) 


Begin the path with a DOS drive letter or a NetWare® volume name. 


Using SEARCH 


¢ To set search paths each time the server comes up, place the SEARCH commands in the 
autoexec.ncf file. 


+ Ifyou execute SECURE CONSOLE, SEARCH is disabled to prevent modules from being 
loaded from directories other than the boot directory. The sys:system search path remains in 
effect, but you cannot create new search paths. 

Once you execute SECURE CONSOLE, you must bring down the server and reboot it to create 
additional search paths. 





NOTE: When the server comes up and volume sys: is mounted, the search path to the boot 
partition is deleted. 





Example 


¢ To display the current server search paths, type 


n 


EARCH 





¢ To add voll:ncf (a network directory) as a search path, type 


n 


EARCH ADD VOL1:NCF 





Additional Information 


Topic See 


Search drives “Network-Search Drive Maps” in the NW 6.5 SP8: File Systems 
Management Guide 


1.152 SECURE CONSOLE 


Purpose 
Use at the server console to increase network security by 


+ Preventing loadable modules from being loaded from any directory other than the boot 
directories—sys : system or c:\nwserver 
+ Preventing keyboard entry into the operating system debugger 


+ Preventing the server date and time from being changed 


Utilities 


185 


Syntax 





SECURE CONSOLE 














Using SECURE CONSOLE 


+ When you execute SECURE CONSOLE, path specifiers are disabled. The sys: system search 
path remains in effect, but you cannot create new search paths. 


+ Use of SECURE CONSOLE is recommended, especially in security-sensitive environments. 
SECURE CONSOLE prevents the following types of breaches in security: 


+ Trojan Horse modules. If you don't use SECURE CONSOLE, a module can be loaded 
from a DOS partition, a diskette drive, or any directory on a NetWare® volume. 


If you allow modules to be loaded from all these drives, anyone who has access to the 
server console can load a loadable module. An intruder could create a module to access or 
alter any information on the server, or to change user account information at the server 
security level. 


+ Date and Time Modifications. Some security and accounting features (such as password 
expiration, time restrictions, intruder detection, and lockout intervals) depend on date and 
time for their enforcement. 


If you don't use SECURE CONSOLE, an intruder can change the date and time at the 
server and bypass these time-dependent features. 


¢ To disable SECURE CONSOLE, use DOWN to bring down the server in an orderly way, and 
then reboot the server. 


Additional Information 


Topic See 
Server console “The Server Console” in the NW 6.5 SP8: Server 


Operating SystemAdministration Guide 


Screen saver and console lock Section 1.150, “SCRSAVER,” on page 182 


1.153 Server 


Purpose 
Use at the server console from the DOS prompt to 


+ Boot the NetWare® operating system on your server 
+ Automatically load bound-in modules 

+ Execute the startup.ncf file 

+ Mount volume sys: 


+ Execute the autoexec.ncf file 
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Syntax 


server [parameter] 


Parameter 


-s [path] fi lename.ncf 


Use to 


Specify an alternative to startup.ncf. Replace filename with the name 


of the alternate file. (The file extension must be .ncf) 


The system looks for the file in the current boot directory, unless you 
specify a path. 


Prevent the autoexec .ncf file that you created in INSTALL from 
executing. 


This parameter is useful if you are changing drivers or other commands in 
your autoexec.ncf file. 


Prevent the startup.ncf and autoexec.ncf files created in INSTALL 
from executing. 


This parameter is useful for changing the boot process. 


Prevent the logo (server splash graphic) from displaying while server 
components are loading in the background. 


Using SERVER 


¢ Server is an executable file containing bound-in modules. Server uses DOS as a cold boot 


loader to boot the NetWare operating system. From then on, NetWare is in control and loads 
modules. 


If neither of the .ncf files exists, Server prompts you for a server name and an IPX™ internal 
network number; Server then brings up the console prompt (:). 





IMPORTANT: The internal net number is used as a server ID in IP networks as well as IPX 
networks. Do not delete it from .ncf files. 





To automatically bring up the server when you boot up the machine, you can place the server 
command in the autoexec.bat file in your boot partition. 


Server executes startup.ncf and autoexec.ncf, if they exist. 


To prevent the Novell® logo (server splash screen) from displaying, you can load Server with 
the -nl (no logo) command option. Otherwise the graphics screen displays for about 10 seconds 
while server components are loading in the background. 





TIP: To substitute a different image for the current logo screen, place a file called nwlogo . bmp 
(for machines using a 256-color palette) or nwlogo16.bmp (for machines using a 16-color 
palette) in the same directory as server.exe (must be in . bmp format). 


BIOS limitations on the size and resolutions of the image are 640x480 pixels. The server will 
display the 256-color version, if possible; otherwise, the server will use the 16-color image. If 
neither is found in the directory, the default logo screen is displayed. 
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Additional Information 
Topic 


Restarting server execution from the console 
prompt 


Bringing the server down 


Editing .ncf files 


1.154 SET 


Purpose 


See 


Section 1.144, “Restart Server,” on page 171 


“Starting and Stopping the Server” in the NW 6.5 
SP8: Server Operating SystemAdministration 
Guide 


“Using Server Batch Files” in the NW 6.5 SP8: 
Server Operating SystemAdministration Guide 


Use at the server console to view and configure operating system parameters. 





TIP: You can also modify server parameter values from Monitor's Available Options, and then 
Server Parameters or using the Set Parameter link in Novell Remote Manager. 





The default SET parameter values give maximum performance for most systems. Server parameter 


values should seldom need to be modified. 


Syntax 


set [parameter] [value] 


Parameter Categories 


“Common File System Parameters” on page 190 
“Communications Parameters” on page 193 
“Directory Services Parameters” on page 200 
“Disk Parameters” on page 204 

“Error Handling Parameters” on page 207 
“Licensing Services Parameters” on page 209 
“Memory Parameters” on page 210 
“Miscellaneous Parameters” on page 213 
“Multiprocessor Parameters” on page 220 

“NCP Parameters” on page 221 


“Novell Storage Services Parameters” on page 226 


“Power Management Parameters” on page 227 


“Service Location Protocol Parameters” on page 229 


“Time Parameters” on page 233 
“Traditional File Parameters” on page 237 


“File Caching Parameters for the Traditional File System” on page 237 
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“Directory Caching Parameters for the Traditional File System” on page 239 
“Allocation of Directory Cache Buffers” on page 240 

“How Directory Caching and File Caching Work Together” on page 240 

“File Parameters for the Traditional File System” on page 243 

“Locks Parameters for the Traditional File System” on page 247 

“Error Handling Parameters for the Traditional File System” on page 249 
“Transaction Tracking Parameters for the Traditional File System” on page 250 


Using SET 


Although most default values of the server parameters don't need to be modified, you might increase 
the performance of your system by adjusting the values of certain parameters. Suggestions for 
improving server performance can be found in “Optimizing the NetWare Server” and “Setting 
Server Parameter Values” in the NW 6.5 SP8: Server Operating SystemAdministration Guide. 


Server parameter settings are persistent in NetWare. If the server goes down, any 
settings that you have made to tune your server for performance will not be lost. 


Displaying and Changing Current Settings 


+ Ifyou type SET without a parameter, a list of numbered categories appears. When you select a 
category, the current settings for the server parameters in that category appear along with a 
brief description of each parameter, the range of valid values, and the default value. 


¢ Ifyou type SET with a parameter but no value, the current setting, range of valid values, and a 
brief description of the parameter are displayed. 


¢ Ifyou type SET with a parameter and a value, the operating system is reconfigured according 
to the specified value. 


You can also use the Monitor utility to modify server parameter values. See Section 1.94, 
“MONITOR,” on page 102. 


Entering Parameters 
+ You can modify the values of most SET parameters at the console prompt. The system is 
immediately configured to that setting. Any setting in the autoexec.ncf file is overridden. 


+ You can enter SET commands that you execute at the console prompt in the autoexec.ncf 
file. When a parameter value is set in this file, the server configures itself to that setting each 
time the server is booted—unless the value is modified. 


+ Some commands can be also saved in the startup.ncf file. Use NWCONFIG (page 146) to 
edit both the autoexec.ncf and the startup.ncf file. 


Parameters That Control the Allocation of Services 


Some SET parameters control how the system dynamically allocates services. Three types of 
parameters interact to control the allocation of a service: 


+ Maximum limits control the amount of server resources the operating system can allocate for a 
particular service. 


+ Minimum limits allow the operating system to allocate a minimum amount of resources as soon 
as a request is received. 
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Low minimum limits slow the growth of a particular service. High minimum limits allow rapid 
growth. 


For example, if the minimum number of directory cache buffers is set to 20, the system 
allocates another buffer resource as soon as a request is made—until 20 cache buffers have 
been allocated. 


When 20 directory cache buffers are allocated, the system waits 2.2 seconds (default) when a 
request comes in, and then allocates another buffer if the request is still active. 


However, if the minimum number of directory cache buffers is set to 40, the system allocates 
40 directory cache buffers before it starts slowing the growth by waiting 2.2 seconds after each 
request. 


+ Wait time limits control how rapidly the operating system can allocate a new resource. 
Common File System Parameters 
Common File System Parameters contain parameters that apply to both the NSS file system and the 
NetWare Traditional file system. For a description of file system parameters, see the following table. 


Table 1-3 Common File System Parameters 


Parameter Use to 


Maximum Transactions number Specify how many transactions can occur at the same time. 
Supported values: 100 to 10000Default: 10000 


Owning NLM: filesys.nlm 


Maximum Concurrent Directory Specify how many write requests from directory cache buffers are 
Cache Writes number put in the elevator before the disk head begins a sweep across 
the disk. 


Supported values: 5 to 500Default: 75 


A high number creates more efficient write requests. A low 
number creates more efficient read requests. 


Owning NLM: filesys.nlm 


Minimum File Delete Wait Time time Specify how long a deleted file remains salvageable on the 
volume. 


Supported values: 0 seconds to 7 daysDefault: 1 minute 5.9 
seconds 


Files deleted for less than this minimum aren't automatically 
purged even if the volume is full and users can't create new files. 


Owning NLM: filesys.nlm 

Immediate Purge of Deleted Files Supported values: On, OffDefault: Off 

value 
If this parameter is set to On, all files are purged immediately 
when they are deleted. 


Owning NLM: filesys.nlm 
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Parameter 


Compression Daily Check Stop Hour 
number 


Compression Daily Check Starting 
Hour number 


Minimum Compression Percentage 
Gain number 


Enable File Compression value 


Maximum Concurrent Compressions 
number 


Use to 


Specify the hour when you want the file compressor to stop 
scanning enabled volumes for files that need to be compressed. 


Supported values: 0 to 23Default: 6 

Hours are specified by a 24-hour clock: (0 midnight; 23 11 p.m.). 
This parameter can be set in the startup. ncf file. 

Owning NLM: filesys.nlm 


Specify the hour when you want the file compressor to start 
scanning enabled volumes for files that need to be compressed. 


Supported values: 0 to 23Default: 0 
Hours are specified by a 24-hour clock: (0 midnight; 23 11 p.m.). 


Note: If the Compression Daily Check Stop Hour parameter is 
the same as the Compression Daily Check Starting Hour, then 
the file compressor starts checking every day at the Compression 
Daily Starting Hour time and runs as long as necessary to finish 
all files that meet the compressible criteria. 


This parameter can be set in the startup. ncf file. 


Set the minimum percentage a file must compress to remain in a 
compressed state. 


Supported values: 0 to 50Default: 20 

This parameter can be set in the startup.ncf file. 

Owning NLM: filesys.nlm 

Specify whether file compression is suspended. 

Supported values: On, OffDefault: On 

On allows file compression on compression-enabled volumes. 


Off suspends compression; immediate compress requests are 
queued until the value is reset to On, when the files meeting 
criteria are compressed. 


This parameter can be set in the startup.ncf. 
Owning NLM: filesys.nlm 


Specify the maximum concurrent or simultaneous compressions 
allowed. 


Supported values: 1 to 8Default: 2 


Concurrent compressions can occur only if there are multiple 
volumes. 


This parameter can be set in the startup.ncf file. 


Owning NLM: filesys.nlm 
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Parameter 


Convert Compressed to 
Uncompressed Option value 


Decompress Percent Disk Space 
Free to Allow Commit number 


Decompress Free Space Warning 
Interval number 


Deleted Files Compression Option 
number 


Days Untouched Before 
Compression number 
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Use to 


Specify what the file system does with an decompressed version 
of a file after the server has decompressed it. 


Supported values: 


0 Always leave the file compressed 1 Leave the file compressed 
until second access if it is read only once during the time 
specified by the Days Untouched Before Compression parameter 
2 Always leave the file decompressed 


Default: 1 
This parameter can be set in the startup.ncf file. 
Owning NLM: filesys.nlm 


Specify the percentage of free disk space required on a volume 
for file decompression to permanently change compressed files 
to decompressed. 


Supported values: 0 to 75Default: 10 


This parameter prevents newly decompressed files from filling up 
the volume. 


This parameter can be set in the startup.ncf file. 
Owning NLM: filesys.nlm 


Specify the time between alerts when the file system is not 
changing compressed files to decompressed because of 
insufficient disk space. Setting the interval to O turns off the alert. 


Supported values: 0 seconds to 29 days 15 hours 50 minutes 
3.8 seconds Default: 31 minutes 18.5 seconds 


This parameter can be set in the startup.ncf file. 
Owning NLM: filesys.nlm 

Specify whether and when deleted files are compressed. 
Supported values: 


0 Don't Compress deleted files 1 Compress deleted files the next 
day 2 Compress deleted files immediately 


Default: 1 
This parameter can be set in the startup.ncf file. 
Owning NLM: filesys.nlm 


Specify the number of days the system waits after a file was last 
accessed before it is compressed. 


Supported values: 0 to 100000Default: 14 
This parameter can be set in the startup.ncf file. 


Owning NLM: filesys.nlm 


Communications Parameters 


Communication parameters control settings for communication buffers. Four parameters configure 
packet receive buffers; four control the watchdog. 


+ Packet Receive Buffers are areas in the server's memory that are set aside to hold data packets. 
The packets remain in the buffers while the server processes them. 


You can monitor the current number of allocated packet receive buffers on Monitor's General 
Information screen. 


+ Watchdog Packets are used to make sure stations are connected. If the server doesn't receive a 
packet from a station within a set time (delay before first watchdog packet), a watchdog packet 
is sent to the station. 


If the station doesn't respond within a configurable amount of time (delay between watchdog 
packets), another packet is sent. 


If the station doesn't respond to a set number of packets, the server assumes that the station is 
no longer connected and clears the station's connection. 


For a description of communications parameters, see Table 1-4 on page 193. 


Table 1-4 Communications Parameters 


Parameter Use to 


IPX CMD Mode Routing value Control whether IPX CMD Mode Routing is on or off. 
Supported values: On, OffDefault: Off 
Owning NLM: ipxspx.nlm 


IPMGMT Push Pull Interval number Change the time (in seconds) between change in the 
configuration and its effect. 


Supported values: 1 to 5Default: 2 


Recommended: If you find that your configuration change is 
reverted to the old one after refresh, increase this time. 


Owning NLM: ipmgmt .nlm 


IPMGMT Fetch Expiry Time number Change the expiration time (in seconds) of IPMGMT Fetch 
operation. 


Supported values: 1 to 60Default: 5 


Recommended: If a lesser number of applications is shown on 
the IP Management page than the actual number of applications 
that are running on the server, increase the time. 


Owning NLM: ipmgmt .nlm 
Maximum Pending TCP Connection Change the maximum number of pending TCP connections. 
Requests number 

Supported values: 128 to 4096Default: 128 


Owning NLM: bsdsock.nlm 
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Parameter 


PGM Socket Send Buffer Size 
number 


BSD Socket default Buffer Size in 
Bytes number 


Discard Oversized Ping Packets 
value 


Largest Ping Packet Size number 


TOS for IP packets number 


Arp entry update time number 


Arp entry expiry time number 
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Use to 


Set the PGM Socket default send buffer size (in bytes). 


Supported values: 102400 to 1073741824Default: 400*1024 
bytes 


Owning NLM: bsdsock.nlm 


Set the BSD Socket default send and receive buffer size (in 
bytes). 


Supported values: 4096 to 1073741824Default: 32768 bytes 
Owning NLM: bsdsock.nlm 


Specify whether or not to discard ping packets larger than the 
current setting of largest ping packet size. 


Supported values: On, OffDefault: On 


+ On Discard 
+ Off Do not discard 


Owning NLM: tcpip.nlm 

Set the largest ping packet size that can be received. 
Supported values: 0 to 36992Default: 10240 

The upper limit is under assumption that MTU is 1500 (Ethernet). 
Owning NLM: tcpip.nlm 


Set TOS in the IP header for all outgoing packets for all 
interfaces. 


Supported values: 0 to 127Default: O 

Owning NLM: tcpip.nlm 

Change the update time (in seconds) of Arp Entries. 
Supported values: 240 to 14400Default: 300 (5 minutes) 


Recomended: The Arp entry update time should be greater 
than or equal to the Arp entry expiration time. 


Owning NLM: tcpip.nlm 
Change the expiration time (in seconds) of Arp Entries. 
Supported values: 240 to 14400Default: 300 (5 minutes) 


Recomended: The Arp entry expiration time should be less than 
or equal to the Arp entry update time. 


Owning NLM: tcpip.nlm 


Parameter 


ICMP Redirect Timeout number 


Largest UDP Packet Size number 


Discard Oversized UDP Packets 
value 


TCP UDP Diagnostic Services value 


TCP Path MTU Black Hole Detection 
and Recovery value 


TCP Max Port Limit number 


TCP Sack Option value 


Use to 


Set the time period (in minutes) for expiring ICMP redirect 
learned routes. 


Supported values: 0 to 525600 (1 year)Default: 3 

A setting of 0 disables route learning from ICMP redirects. 
Owning NLM: tcpip.nlm 

Set the largest UDP packet size that can be received. 
Supported values: 0 to 36992Default: 16384 

The upper limit is under assumption that MTU is 1500 (Ethernet). 
Owning NLM: tcpip.nlm 


Specify whether to discard UDP packets larger than the current 
setting of Largest UDP Packet Size. 


Supported values: On, OffDefault: On 


+ On Discard 
+ Off Do not discard 


Owning NLM: tcpip.nlm 


Start or stop diagnostic servers over TCP and UDP (Echo/ 
Chargen/Discard). 


Supported values: On, OffDefault: Off 
Owning NLM: tcpip.nlm 


Enable or disable Path MTU Black Hole Detection and Recovery 
feature. 


Supported values: On, OffDefault: Off 


+ On Enable 
+ Off Disable 


Owning NLM: tcpip.nlm 

Modify the upper limit of TCP ephemeral port range. 
Supported values: 4999 to 54999Default: 54999 
Owning NLM: tcpip.nlm 


Enable or disable Sack support. This option does not change the 
behaviour of existing connections. 


Supported values: On, OffDefault: On 


+ On Enable 
+ Off Disable 


Owning NLM: tcpip.nlm 
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Parameter 


TCP Large Window Option value 


TCP Defend Land Attacks value 


TCP Secure ISN value 


Maximum RIP SAP Events number 


IPX Router Broadcast Delay number 
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Use to 


Enable or disable Large Window support. This option does not 
change the behaviour of existing connections. 


Supported values: On, OffDefault: On 


+ On Enable 
+ Off Disable 


Owning NLM: tcpip.nlm 
Defend against TCP/UDP Land Attacks. 
Supported values: On, OffDefault: On 


+ On Defend 
+ Off Do not defend 


Owning NLM: tcpip.nlm 


Enable or disable the use of a secure algorithm for generating 
TCP Initial Sequence Numbers. This option does not change the 
behaviour of existing connections. 


Supported values: On, OffDefault: On 


+ On Discard 
+ Off Do not discard 


Owning NLM: tcpip.nlm 


Specify the maximum number of RIP/SAP process time events 
(such as RIP/SAP consumption) allowed before guaranteeing 
that a thread switch will occur. 


Supported values: 1 to 100000Default: 100 
Owning NLM: ipxspx.nlm 


Specify how long (in ticks) the IPX router should delay between 
SAP/RIP broadcast packets. 


Supported values: 0 to 2Default: 0 


+ 0 Adjust delay to size of SAP/RIP tables 
+ 1 Delay 1 tick 
+ 2 Delay 2 ticks 


Owning NLM: ipxspx.nlm 


Parameter 


IPX NetBIOS Replication Option 
number 


Use Old Watchdog Packet Type 
value 


Reply to Get Nearest Server value 


Number of Watchdog Packets 
number 


Delay Between Watchdog Packets 
time 


Delay Before First Watchdog Packet 
time 


Use to 


Control how the IPX router deals with NetBIOS replicated 
broadcasts. 


Supported values: 0 to 3Default: 2 


+ 0 Do not replicate NetBIOS replicated broadcasts. 


+ 1 Replicate NetBIOS replicated broadcasts using the "old" 
algorithm (which causes duplicate broadcasts when there 
are redundant routes). 


+ 2 Replicate NetBIOS replicated broadcasts using the "new" 
algorithm (which squelches duplicate broadcasts but 
doesn't go as far). 


+ 3 Use the same replication as method 2, but do not replicate 
NetBIOS replicated broadcasts to WAN links. 


Owning NLM: ipxspx.nlm 


Use type 0 instead of type 4 for watchdog packets. Some old 
router hardware will filter out type 4 IPX packets that can cause a 
client to lose its connection to the sever when it sits inactive for a 
few minutes.. 


Supported values: On, OffDefault: Off 
Owning NLM: ipxspx.nlm 


Specify whether the server responds to GET NEAREST 
SERVER requests from workstations that are attempting to locate 
a server. 


Supported values: On, OffDefault: On 
Owning NLM: ipxspx.nlm 


Specify the number of unanswered watchdog packets that the 
server sends to a workstation before closing its connection. 


Supported values: 5 to 100Default: 10 
Owning NLM: connmgr.nlm 
Specify the amount of time between watchdog packets. 


Supported values: 9.9 seconds to 10 minutes 26.2 seconds 
Default: 59.3 seconds 


After a server sends out the first watchdog packet, it waits the 
specified time before sending out succeeding packets if it 
receives no reply. 


Owning NLM: connmgr.nlm 


Specify the amount of time the server waits without receiving a 
request from a workstation before sending out the first watchdog 
packet to that station. 


Supported values: 15.7 seconds to 14 daysDefault: 4 minutes 
56.6 seconds 


Owning NLM: connmgr.nlm 
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Parameter 


Console Display Watchdog Logouts 
value 


Maximum Packet Receive Buffers 
number 
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Use to 


Specify whether a console message is displayed when a 
connection is cleared. 


Supported values: On, OffDefault: Off 


If your network is running smoothly, you don't need to display 
watchdog logouts. 


If your workstations are having connection problems, the 
watchdog logout messages can help you isolate which stations 
aren't receiving or sending watchdog packets. 


Owning NLM: connmgr.nlm 


Specify the maximum number of packet receive buffers the 
operating system can allocate. 


Supported values: 50 to 3303820Default: 10000 


Before increasing this parameter, use MONITOR to view the 
server's use of packet receive buffers and service processes. 


If the number of packet receive buffers is at maximum, increase 
this parameter in increments of 10 until you have one packet 
receive buffer per workstation. 


If you have EISA or microchannel bus master boards in your 
server, increase this parameter to provide at least five buffers per 
board. 


If the board is producing No ECB available count errors, provide 
10 buffers per board. Use MONITOR (LAN/WAN Drivers) to 
determine whether the board is producing errors. 


If the number of allocated service processes is at maximum, you 
can increase the Maximum Service Processes parameter to 
decrease the need for more packet receive buffers. 


The value of this parameter should be greater than the value of 
the Minimum Packet Receive Buffers parameter. If it is less, the 
system increases the value to match that of the Minimum Packet 
Receive Buffers parameter. 


This parameter can be set in the appropriate startup file. 


Owning NLM: 1s1.n1m 


Parameter 


Minimum Packet Receive Buffers 
number 


Maximum Physical Receive Packet 
Size number 


New Packet Receive Buffer Wait 
Time time 


Use to 


Specify the minimum number of packet receive buffers the 
operating system can allocate. The operating system allocates 
this number of buffers as soon as the server boots. You must add 
this command to the startup.ncf file. You cannot change the 
setting at the console prompt. 


Supported values: 10 to 32768Default: 2000 


Before increasing this parameter, use Novell Remote Manager or 
MONITOR to view the server's use of packet receive buffers. 


If you have EISA or microchannel bus master boards in your 
server and are receiving No ECB available count errors (see 
LAN/WAN Drivers in Section 1.94, “MONITOR,” on page 102) 
right after the server boots, increase this parameter so that each 
board can have at least five packet receive buffers. 


If the allocated number is higher than 10 and the server doesn't 
respond immediately after booting, increase this parameter. 


The value of this parameter must be less than the value of the 
Maximum Packet Receive Buffers parameter. If it is greater, the 
system increases the value of the Maximum Packet Receive 
Buffers parameter to match that of the Minimum Packet Receive 
Buffers parameter. 


Owning NLM: 1s1.n1m 


Specify the maximum size of packets that can be transmitted on 
the network. 





IMPORTANT: You must add this command to the startup.ncf 
file. You cannot change the setting at the console prompt or by 
using any other utilties. 





Supported values: 618 to 65642Default: 4224 


The default allows 2 KB (data with the packet header). If you use 
token ring or Ethernet boards, the default is acceptable. 


If some of your network boards transmit more than 512 bytes of 
data per packet, set this parameter for the largest packet size. 


Owning NLM: 1s1.n1m 


Specify how long (in seconds) the operating system waits after 
receiving a request for a packet receive buffer before granting a 
new buffer. 


Supported values: 0 seconds to 20Default: 0 


This parameter prevents the system from granting too many 
buffers during a sudden peak in usage. 


If you have an EISA bus master board in your server, don't 
change this parameter. 


Owning NLM: 1s1.n1m 
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Parameter 


Maximum Interrupt Events number 


Directory Services Parameters 


Use to 


Specify the maximum number of interrupt time events (such as 
IPX routing) allowed before a thread switch is guaranteed to have 
occurred. 


Supported values: 1 to 1000000Default: 10 


Owning NLM: 1s1.n1m 


Directory services parameters allow you to do the following: 


+ Control the Novell eDirectory™ trace file. 


+ Set time intervals for maintenance processes that reclaim disk space, remove external 
references, and check the consistency of backlinks. 


¢ Set eDirectory synchronization intervals and restrictions. 


+ Specify the number of NCP™ retries before timeout. 
+ Mark the status of other servers in the namebase as UP or DOWN. 


+ Specify bindery services contexts. 


+ Handle security issues. 


For descriptions of directory services parameters, see the following table. 


Table 1-5 Directory Services Parameters 


Parameter 


NDS Trace to Screen value 


NDS Trace to File value 
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Use to 


Enable the DS trace screen; this displays information about 
eDirectory events on the monitor. 


Supported values: On, OffDefault: Off 
Owning NLM: ds.nlm 


Send messages about eDirectory events to the eDirectory trace 
file on volume sys:. The default file is system: \dstrace.dbg. 


Supported values: On, OffDefault: Off 


The file path and name can be changed with the eDirectory Trace 
Filename parameter. 


The file is circular; it grows to a maximum length of approximately 
500 KB and then starts to overwrite itself at the beginning of the 
file. 


If this parameter is set to On, the trace information is also scrolled 
on the screen. 


Owning NLM: ds.nlm 


Parameter 


NDS Trace Filename path\name 


Bindery Context context;context 


NDS External Reference Life Span 
number_in_hours 


NDS Inactivity Synchronization 
Interval number_in_minutes 


Use to 

Specify the path and name of the DS trace file on volume sys:. 
Maximum length: 254 

Default: system: \dstrace.dbg 

Owning NLM: ds.nlm 


Specify one or more containers to be used by eDirectory when it 
provides bindery services. 


Maximum: 2047 characters, 16 contexts 


Multiple contexts are separated by semicolons ( ; ). Whatever 
string it specified is set. To make that string effective for all valid 
contexts, make sure the container you specify in the context is 
present on that server. 


Example: set bindery context 
ou=sales_la.ou=sales. 
o=novell us;ou=accounting.o=novell 


This parameter can be set in the startup.ncf file. 
Owning NLM: server.nlm 


Specify how long (in hours) unused external references are 
allowed to exist before being removed. 


Supported values: 1 to 384Default: 192 


External references are local IDs assigned to users when they 
access other servers. When users no longer have access, the 
external references should be removed. 


Owning NLM: ds.nlm 


Specify the maximum elapsed time (in minutes) between 
exhaustive synchronization checks. As soon as you change this 
value, the system executes the synchronization check. 
Synchronization checks then recur at the specified interval. 


Supported values: 2 to 1440Default: 60 


If the system has replicas across a WAN link, this value should be 
set as high as 240 (4 hours) to reduce WAN traffic. 


Owning NLM: ds.nlm 
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Parameter 


NDS Synchronization Restrictions 
value, version_number_list 


NDS Servers Status value 


NDS Janitor Interval 
number_in_minutes 
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Use to 


Specify which versions of eDirectory the server can synchronize 
with. 


Supported values: Off; On, list of version numbers (Maximum 
length of version number list: 131 characters) 


Default: Off 


To determine what version is currently loaded on a server, enter 
modules at the server prompt. The eDirectory version number is 
displayed under the heading ds .n1m. 


If this parameter is set to Off, the server synchronizes with all 
versions available. 


If this parameter is set to On, the server synchronizes only with 
those versions specified as parameters to the On value. 


Example: On,420,421 
Owning NLM: ds.nlm 


Mark the status of all Server objects in the local namebase as up 
or down. 


Supported values: Up, Down 


Use this parameter to reset the status of all the servers if the 
status of one server isn't accurately recognized by the system. 


For example, if a server is up but the system recognizes it as 
down, set this parameter to mark all servers as up. 


Subsequently, the system would reassess the status of all 
servers and change the status to down for those servers that 
were truly down. 


Owning NLM: ds.nlm 


Specify the interval (in minutes) at which the janitor process is 
executed. The janitor process is executed as soon as you change 
this value and then recurs at the specified interval. 


Supported values: 1 to 10080Default: 720 


The janitor process cleans up unused records, reclaims disk 
space, and purges objects flagged for deletion. 


Owning NLM: ds.nlm 


Parameter 


NDS Distributed Reference Link 
Interval number_in_minutes 


NDS Bindery QOS mask number 


NDS Bindery QOS delay 
number_in_milliseconds 


NDS Backlink Interval 
number_in_minutes 


NDS Trace File Length to Zero value 


Use to 


Specify the interval (in minutes) at which distributed reference link 
consistency checking is performed. Distributed reference link 
consistency checking is executed as soon as you change this 
value. It then recurs at the specified interval. 


Supported values: 2 to 10080Default: 780 


A distributed reference link indicates that an object in a partition 
has an ID in that partition where the actual object doesn't exist. 


This process creates needed distributed reference links and 
deletes unnecessary ones. 


Owning NLM: ds.nlm 


Select which objects should be subject to bindery QOS delay. 
This switch should be used with the NDS Bindery QOS delay 
switch. 


Supported values: 0 to 4294967295Default: 8 
Owning NLM: ds.nlm 


Set the delay (in milliseconds) after sucessfuly finding bindery 
objects. This switch should be used with the NDS Bindery QOS 
mask switch. 


Supported values: 0 to 60000Default: 150 
Owning NLM: ds.nlm 


Specify the interval (in minutes) at which backlink consistency 
checking is performed. Backlink consistency checking is 
executed as soon as you change this value. It then recurs at the 
specified interval. 


Supported values: 2 to 10080Default: 780 


A backlink indicates that an object in a replica has an ID ona 
server where the replica doesn't exist. 


This process creates needed backlinks and deletes unnecessary 
ones. 


Owning NLM: ds.nlm 


Delete the contents of the trace file. This parameter does not 
delete the file itself. As soon as the file is cleared, the value of the 
parameter resets to Off. 


Supported values: On, OffDefault: Off 


To use this parameter, you must also set the eDirectory Trace to 
File parameter to On, because the trace file must be open for the 
system to delete its contents. 


Owning NLM: ds.nlm 
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Parameter 


NDS Bootstrap Address address 


Check Equivalent to Me value 


Disk Parameters 


Use to 


Allow eDirectory to operate properly in the absence of SLP. When 
SLP is not available to advertise servers and partitions, the local 
server uses this value to set the bootstrap address that the server 
would use to find its tree and authenticate to it. 


Format for IP Address: Use the standard IP format of four 
decimal values delimited by periods. 


Example: 123.45.67.89 <:524> or 137.65.62.144 (port number is 
optional) This number is used for both TCP and UDP 
connections. 


Format for IPX Address: Use the standard IPX format of 
hexadecimal digits representing Network, Node, and Socket. 


Example: 12345678:23456789ABCD:0451 or 
01010480:00001B1E983A:0451 


Defaults apply to any field not present, where the default is 
current value. 


Owning NLM: ds.nlm 


Enforce checking of the Equivalent To Me attribute on eDirectory 
authentication. 


Supported values: On, OffDefault: Off 


If this parameter is set to On, DSRepair must be used to 
synchronize the Equivalence attribute and the Equivalent To Me 
attribute. 


Setting this parameter to On might adversely affect 
communication performance. 


Owning NLM: ds.nlm 


Disk parameters control aspects of disk reads and writes. 


For a description of disk parameters, see the following table. 


Table 1-6 Disk Parameters 


Parameter 


Auto scan for devices value 
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Use to 


Automatically scan for devices when a HAM is loaded. If turned 
off, operator must issue a Scan for New Devices on the 
command line before the devices will be seen. 


Supported values: On, OffDefault: On 


Owning NLM: nwpa.nlm 


Parameter 


Auto load of CDM modules value 


Sequential Elevator Depth number 


Enable lO Handicap Attribute value 


Mirrored Devices Are Out of Sync 
Message Frequency time 


Remirror Block Size number 


Concurrent Remirror Requests 
number 


Use to 


Automatically scan and load defined generic Custom Device 
Modules (CDMs). If turned off, the desired CDMs must be loaded 
manually or added to the startup.ncf file. 


Supported values: On, OffDefault: On 
Owning NLM: nwpa.nlm 
Set the maximum elevator depth for sequential requests. 


Media Manager sends the number of sequential requests up to 
this value to the same device. When the device contains this 
number of requests and another device in the mirror group is 
empty, Media Manager begins sending requests to the idle 
device. 


Supported values: 0 to 4294967295Default: 8 
You can set this parameter in the startup.ncf file. 
Owning NLM: mm.nlm 


Enable drivers and applications to inhibit read requests from one 
or more devices. 


Supported values: On, OffDefault: Off. 


Setting this parameter to On enables the Inhibit attribute to 
function. Setting this parameter to Off prevents the attribute from 
functioning. 


Do not set this attribute to On unless instructed to do so by a 
device manufacturer. 


You can set this parameter in the startup.ncf file. 

Owning NLM: mm.nlm 

Set the frequency (in minutes) for checking out-of-sync devices. 
Supported values: 5 to 9999Default: 28 

You can set this parameter in the startup.ncf file. 

Owning NLM: mm.nlm 


Set the remirror block size in 4 KB increments. (1=4 KB, 2=8 KB, 
8=32 KB, etc.) 


Supported values: 1 to 8Default: 1 

Owning NLM: mm.nlm 

Set the number of remirror requests per Mirror object. 
Supported values: 2 to 32Default: 32 


Owning NLM: mm.nlm 
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Parameter 


Ignore Partition Ownership value 


Ignore Disk Geometry value 


Multi-path Support value 


Enable Hardware Write Back value 


Enable Disk Read After Write Verify 
value 
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Use to 


Specify whether partitions owned by other servers in a cluster 
can be activated on this server. 


Setting this parameter to On allows partitions owned by other 
servers in the cluster to be activated on this server. 


Supported values: On, OffDefault: Off 
Owning NLM: mm.nlm 

Create nonstandard and unsupported partitions. 
Supported values: On, OffDefault: Off 


If you set this parameter to On before modifying or creating a 
partition, the software ignores disk geometry when creating the 
partition. This allows you to create nonstandard partitions. 


Caution: Setting this parameter to On might harm other file 
systems contained on the disk. 


You can set this parameter in the startup.ncf file. 
Owning NLM: mm.nlm 


Enable or disable support for multipath devices or adapter 
failover. 


Supported values: On, OffDefault: Off 
Owning NLM: mm.nlm 
Enable hardware write back, if supported. 


Hardware write back means that I/O write requests might be 
cached at the device and succeeded before data is committed to 
the media. Hardware write back usually improves write 
performance. 


Supported values: On, OffDefault: Off 
You can set this parameter in the startup.ncf file. 
Owning NLM: mm.nlm 


Control whether information written to disk is read back and 
compared with the original data. 


Supported values: On, OffDefault: Off 


Setting this parameter to On might decrease performance 
significantly. 


To set this value for currently loaded disks, use the Storage 
Devices option of MONITOR (page 102). 


You can set this parameter in the startup.ncf file. 


Owning NLM: mm.nlm 


Parameter Use to 


Auto LFVMount Control whether any local FAT volumes not recognized by DOS 
are automatically mounted and assigned a local drive letter when 
they are detected. 


Supported values: On, OffDefault: Off 


On automatically mounts and assigns a local drive letter when 
the drive is detected. 


When set to Off, you must use the LFVMOUNT comand to 
manually mount local FAT volumes. 


Owning NLM: fatfs.nlm 


Error Handling Parameters 


Error handling parameters control the size of error logs and specify what happens when logs exceed 
the specified size. They also control how the server responds to an abend or to an NLM that does not 
unload from a protected address space. 


For descriptions of error handling parameters, see the following table. 


Table 1-7 Error Handling Parameters 


Parameter Use to 

Server Log File State number Control what happens when the sys$1log.err file is larger than 
the size specified by the Server Log File Overflow Size 
parameter. 


Supported values: 


O Leave sys$log.err as is 1 Delete sys$log.err 2 Rename 
sysSlog.err 


Default: 1 
You can set this parameter in the startup.ncf file. 
Owning NLM: server.nlm 


Server Log File Overflow Size Specify the maximum size of the sys$log. err file before the 
number action specified by the Server Log File State parameter occurs. 


Supported values: 65536 to 4294967295Default: 4194304 
You can set this parameter in the startup.ncf file. 


Owning NLM: server.nlm 
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Parameter 


Boot Error Log File State number 


Boot Error Log File Overflow Size 
number 


Boot Error Log value 


Hung Unload Wait Delay number 


Auto Restart Down Timeout number 
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Use to 


Control what happens when the boot $log.err file is larger 
than the size specified by the Boot Error Log Overflow Size 
parameter. 


Supported values: 


O Leave boot Slog.err as is 1 Delete boot$log.err 2 
Rename boot $log.err 3 Start a new log file whenever the 
server is restarted 


Default: 3 
You can set this parameter in the startup.ncf file. 
Owning NLM: server.nlm 


Specify the maximum size to which the boot $log.err file can 
grow before the action specified by the Boot Error Log File State 
parameter occurs. 


Supported values: 65536 to 4294967295Default: 4194304 
You can set this parameter in the startup.ncf file. 
Owning NLM: server.nlm 


Specify which error messages from the console will be saved in 
the boot$log.err file. 


Supported values: On, OffDefault: On 


If you set this parameter to On, all error messages displayed on 
the console will be saved in boot$log.err. 


If you set this parameter to Off, only error messages displayed 
during the boot procedure will be saved in boot$log.err. 


You can set this parameter in the startup. ncf file. 
Owning NLM: server.nlm 


Specify the amount of time the server waits for an NLM program 
to be unloaded from a protected address space after the unload 
address space command is executed. If the NLM is not 
successfully unloaded within this interval, the server displays a 
prompt to kill the address space. 


Supported values: 0 seconds to 1 minute 58.3 secondsDefault: 
30 seconds 


You can set this parameter in the startup. ncf file. 
Owning NLM: server.nlm 


When the server tries to go down after an abend, it sets a timeout 
just in case there is a problem going down. Specify the amount of 
time (in seconds) that the server waits before automatically 
restarting. 


Supported values: 0 to 600Default: 180 


Owning NLM: server.nlm 


Parameter 


Auto Restart After Abend Delay Time 
number 


Auto Restart After Abend value 


Use to 


Specify the amount of time (in minutes) before the server is 
brought down after an abend, if the Auto Restart After Abend 
parameter is in effect. 


Supported values: 2 to 60Default: 2 


Regardless of what time is set, the server sends a message 
every two minutes to warn users that the server will be brought 
down. 


Owning NLM: server.nlm 
Specify the system's automatic response to an abend. 
Supported values: 


+ 0 The system does not respond to the abend. 


+ 1 After an abend, the system determines the source of the 
abend. Based on findings, the system either keeps the 
computer running or shuts down the computer and attempts 
to restart it. 


+ 2 After an abend, the system attempts to recover from the 
problem and restart the computer after the time specified by 
the Auto Restart After Abend Delay Time parameter. 


+ 3 After an abend, the system immediately restarts the 
computer. 


Default: 1 


For values 1, 2, or 3 to take effect, the Developer Option 
parameter described in “Miscellaneous Parameters” on page 213 
must be set to Off. 


If the server is to be shut down, the system sends a message 
every two minutes to warn all connections. 


To configure the amount of time the system waits before shutting 
down the server, use the Auto Restart After Abend Delay Time 
parameter. 


After an abend, the screen displays information about the abend. 
This information is sent to the abend. log file on the c: drive. 
After the server is shut down and restarted, the abend. 1og file is 
transferred to sys: system. 


Important: Because the server can abend and be restarted 
automatically, you should determine whether any abends have 
occurred. Periodically check either the abend . log file or the 
Server Up Time field on MONITOR's General Information screen. 
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Licensing Services Parameters 


Licensing service parameters control Novell Licensing Service diagnosis features. 


For a description of licensing parameters, see Table 1-8 on page 210. 
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Table 1-8 Licensing Service Parameters 


Parameter Use to 
NLS Search Type Specify the scope of a license certificate search. 
Supported values: 
0 Search to the root of the tree 
1 Search to the root of the partition 
Default: 0 


You must set this parameter in either the startup.ncf or 
autoexec .ncf file for the changes to be persistent. 


Owning NLM: nlslsp.nlm 
Store NetWare 5 Conn SCL MLA Supported Values: On, OffDefault: On 


usage in NDS 
Owning NLM: n1s1sp.nlm 


Memory Parameters 


Memory parameters control garbage collection, corruption checking, the amount of memory below 
16 MB available to device drivers, and aspects of protected and virtual memory. 


For a description of memory parameters, see the following table. 
Table 1-9 Memory Parameters 


Parameter Use to 


Restart Server on Address Space Specify which actions to take during a server cleanup. 


Cleanup Failure value 
Supported Values: On, OffDefault: Off 


When this parameter is On and the server is unable to completely 
clean up an address space after a memory protection error, then 
the server reacts according to the Auto Restart settings. (See the 
Auto Restart parameters in “Error Handling Parameters” on 
page 207.) 


When this set parameter is Off, address spaces with cleanup 
failures will be isolated. 
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Parameter 


Memory Protection Abend After 
Restart Count value 


Memory Protection Restart Count 
number 


Memory Protection No Restart 
Interval value 


Use to 


This parameter works in conjunction with the Memory Protection 
No Restart Interval and Memory Protection Restart Count 
parameters. 


Supported Values: On, offDefault: Off 


If this parameter is On, then the server abends if an address 
space has restarted more than the number of times specified in 
the Memory Protection Restart Count parameter in the time 
interval specified by the Memory Protection No Restart Interval 
parameter. 
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Specify the number of restarts allowed during the Memory 
Protection No Restart Interval. 


Supported Values: 0 to 1000Default: 1 


This parameter works in conjunction with the Memory Protection 
No Restart Interval parameter. 


The default value is 1, meaning that if more than one protection 
fault occurs in an address space, then the address space will be 
restarted only once. 


If you want to configure NetWare to allow two restarts during a 
three-minute period, then you should set the Memory Protection 
Restart Count to 2 and the Memory Protection No Restart Interval 
to 3. 
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Prevent a server from restarting a protected address space that 
continues to fault. 


Supported Values: 0 to 60 minutesDefault: 1 


If the address space faults but has already been restarted within 
the time period specified by this parameter, the server will not 
restart the address space. Restart functionality is disabled for the 
address space. 


A restartable address space that continues to fault consumes 
server resources because the server is forced to continually shut 
down and restart the space. 


Setting the value to 0 disables the parameter so that the address 
space will always be restarted if it faults. 


You can set this parameter in the startup.ncf file. 
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Parameter 


Memory Protection Fault Cleanup 
value 


Average Page In Alert Threshold 
value 


Garbage Collection Interval number 


Alloc Memory Check Flag value 
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Use to 


Enable the server to clean up a protected address space that has 
faulted. 


Supported Values: On, OffDefault: On 


If this parameter is on and a protected address space faults, the 
server removes the address space and its NLM programs and 
returns the resources to the system. 


If this parameter is off and a protected address space faults, the 
server does not remove the address space or return resources to 
the system. The situation is left to the abend recovery 
mechanism. 


You can set this parameter in the startup.ncf file. 
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Specify the point at which the server sends an alert to the console 
because excessive memory swapping indicates the server might 
be low on memory. 


Supported values: 0 to 4294967295Default: 2000 


The value of the parameter is the average number of pages 
swapped from disk to memory per second, calculated over the 
last five seconds. 


If the average page-in rate is high, it means a large amount of 
data is being swapped to and from disk, indicating that the server 
might be running low on memory. 


You can set this parameter in the startup.ncf file. 
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Specify the maximum time between garbage collections. 
Supported values: 1 minute to 1 hourDefault: 5 minutes 
You can set this parameter in the startup.ncf file. 
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Specify whether the server will check for corruption in the alloc 
memory nodes. 


Supported values: On, OffDefault: Off 
You can set this parameter in the startup.ncf file. 


Owning NLM: server.nlm 


Parameter 


Reserved Buffers Below 16 Meg 
number 


Miscellaneous Parameters 


Use to 


Specify the number of file cache buffers reserved for device 
drivers that can't access memory above 16 MB. 


Supported values: 8 to 2000Default: 300 


You must set this parameter in the startup.ncf file. You 
cannot set the value at the command line. Callback may be called 
at startup time. 
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Miscellaneous parameters do not fit aptly or neatly into other categories. The functionality is listed 


below and described in Table 1-10. 


+ Default response to optional commands 


+ Adding the server's name to the console prompt 


+ Configuring alerts 


¢ Controlling alerts for lost or spurious interrupts 


+ Specifying response when invalid parameters are detected 


+ Enabling developer options 


¢ Controlling allocation of service processes 


+ Password security 


+ Enabling execution of secure.ncf at startup 


+ Controlling aspects of the kernel, scheduler, and threads 


Table 1-10 Miscellaneous Parameters 


Parameter 


Display Incomplete IPX Packet Alerts 
value 


Enable SECURE.NCF=value 


Use to 


Specify whether alert messages are displayed when IPX receives 
incomplete packets. This parameter can be used as a debugging 
tool. 


Supported values: On, OffDefault: On 

You can set this parameter in the startup.ncf file. 
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Execute the secure.ncf file at server startup. 
Supported values: On, OffDefault: Off 


You can set this parameter in the autoexec.ncf or 
startup.ncf file. 
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Parameter 


Allow Audit Passwords value 


Command Line Prompt Default 
Choice value 


Command Line Prompt Time Out 
time 


Sound Bell for Alerts value 


Replace Console Prompt with Server 
Name value 
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Use to 


Specify whether passwords can be used to identify auditors. 
Supported values: On, OffDefault: Off 
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Specify a default response to an optional command in an .ncf 
file. 


An optional command in an .ncf file is preceded by a question 
mark (?). The question mark causes the file to prompt you to 
execute the command. For information about optional commands 
in .ncf files, see “Using Server Batch Files” in the NW 6.5 SP8: 
Server Operating SystemAdministration Guide. 


Supported Values: On, OffDefault: On 


On means the default response to the command prompt is Y 
(Yes). If the user does not respond to the prompt within a 
specified time period, the command is executed by default. 


Off means the default response to the command prompt is N 
(No). If the user does not respond to the prompt within a specified 
time period, the command is not executed. 


To specify the time period before the response is executed, use 
the Command Line Prompt Timeout parameter. 
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Specify how long (in seconds) an .ncf file waits before 
executing the default response to an optional command. 


An optional command in an. ncf file is preceded by a question 
mark (?). The question mark causes the file to prompt you to 
execute the command. For information about optional commands 
in .ncf files, see “Using Server Batch Files” in the NW 6.5 SP8: 
Server Operating SystemAdministration Guide. 


Supported Values: 0 to 4294967295Default: 10 
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Control whether a bell sounds when an alert message appears 
on the console. 


Supported values: On, OffDefault: On 
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Control whether the console prompt is replaced with the NetWare 
server name. 


Supported values: On, OffDefault: On 
You can set this parameter in the startup.ncf file. 


Owning NLM: server.nlm 


Parameter 


Alert Message Nodes number 


Classic Work to do Pre-check Flag 


Worker Thread Execute In a Row 
Count number 


Halt System on Invalid Parameters 
value 


Use to 


Specify the number of alert message nodes that have been 
previously allocated. 


Supported values: 10 to 256Default: 20 
You can set this parameter in the startup.ncf file. 
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When a classic work to do is scheduled, this flag causes the 
scheduler to verify if the work to do is scheduled. If it's on the 
scheduled list, the operating system will trap. 


Supported values: On, OffDefault: Off 
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Specify the number of times the scheduler consecutively 
dispatches new work before allowing other threads to run. 


Supported values: 1 to 20Default: 10 


Worker threads are created by the kernel to perform work for the 
kernel itself. 
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Specify whether to stop the system when invalid parameters are 
detected. 


Supported values: 


On You want the system to stop when an invalid parameter or 
condition is detected 


Off You want the system to display an alert and continue running 
when an invalid parameter or condition is detected 


Default: Off 
You can set this parameter in the startup.ncf file. 
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Parameter 


Display Relinquish Control Alerts 
value 


Display Old API Names value 
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Use to 


Control whether messages about processor control are sent to 
the server console. This parameter can be used as a debugging 
tool. 


Supported values: 


On Use if you're writing your own loadable modules Off Use if 
you're not writing your own loadable modules 


Default: Off 


If a module uses the processor for more than 0.4 seconds without 
relinquishing control to other processes, the following types of 
messages appear: 


process_name: Process did not relinquish control frequently 
Module: module_name Code offset in module: memory_address 


You can set this parameter in the startup.ncf file. 
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Control messages about outdated API functions from earlier 
versions of NetWare. This parameter can be used as a 
debugging tool. 


Supported values: On, Off 


On Use if you write your own modules and you are upgrading 
your NetWare modules to use newer APIs 


Off Use if you aren't upgrading modules 
Default: Off 


The following types of messages appear when a module is 
loaded that uses the obsolescent APIs: 


Module is using old API: SetInterruptVector Module is using old 
API: ReturnPermanentMemory Module is using old API: 
AllocateReturnablePermMemory 


If you receive messages such as these, contact the vender of the 
module. 


You can set this parameter in the startup.ncf file. 


Note: Outdated API functions are those that have been replaced 
with newer, more efficient functions. These functions still work— 
they are not obsolete—but they work more slowly. Outdated API 
functions are not limited to NetWare 3 versions. 


Also, not all older API functions have been replaced—many of 
them are still in use. 
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Parameter 


CPU Hog Timeout Amount number 


Developer Option value 


Display EOI Threshold number 


Display EOI value 


Display Spurious Interrupts Threshold 
number 


Use to 


Specify the amount of time (in seconds) to wait before terminating 
a thread that has not relinquished control of the processor. 


Supported values: 0 to 3600 (1 hour)Default: 60 

A value of 0 (zero) disables this option. 

You can set this parameter in the startup.ncf file. 
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Control whether options associated with a developer environment 
are enabled. 


Supported values: On, OffDefault: Off 
You can set this parameter in the startup.ncf file. 
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Specify the number of spurious interrupts that are allowed to 
happen before inserting a delay before the End of Interrupt (EOI). 


The delay before the EOI is added only if the threshold is reached 
and the Delay EOI SET parameter value On. 


You can set this parameter in the startup.ncf file. 
Supported values: 1 to 1000000Default: 200 
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Control whether a delay is inserted before the End of Interrupt 
(EOI). Specify the number of spurious interrupts that are allowed 
to happen before inserting a delay before the EOI. 


Setting this parameter to On allows a delay to be inserted prior to 
the EOI. The delay is inserted only if the number of spurious 
interrupts reaches the value set by the Delay EOI Threshold SET 
parameter. 


You can set this parameter in the startup.ncf file. 
Supported values: On, OffDefault: On 
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Set the minimum number of spurious interrupts per second that 
must be detected before a spurious interrupt alert message is 
displayed on the system console. 


Supported values: 1 to 1000000Default: 200 





NOTE: The Set Display Lost Interrupt Alerts parameter must also 
be set to On. 





You can set this parameter in the startup.ncf file. 
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Parameter 


Display Lost Interrupts Threshold 
number 


Display Spurious Interrupt Alerts 
number 


Display Lost Interrupt Alerts value 
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Use to 


Set the minimum number of lost interrupts per second that must 
be detected before a lost interrupt alert message is displayed on 
the system console. 


Supported values: 1 to 1000000Default: 10 


Note: The Set Display Lost Interrupt Alerts must also be set to 
On. 


You can set this parameter in the startup.ncf file. 
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Control alert messages displays when a spurious hardware 
interrupt is detected. 


Supported values: On, OffDefault: Off 


A spurious interrupt occurs when hardware in the server creates 
an interrupt that is defined and reserved for another device. 


Spurious interrupts generate the following message: Spurious 
hardware interrupt number detected. 


This message indicates a serious error in the hardware. 


If your server console displays this message, remove all add-on 
boards and run SERVER. 


If the message doesn't appear, add the boards one at a time to 
determine which hardware is creating the spurious interrupt. 
Then contact the vendor. 


Set the parameter to Off while you are waiting for a resolution. 
You can set this parameter in the startup.ncf file. 

Owning NLM: server.nlm 

Control alert messages about lost interrupts. 

Supported values: On, OffDefault: Off 


A lost interrupt occurs when a driver or board requests a service 
with an interrupt call and then drops the request before the 
processor can respond. 


Lost interrupts generate the following message: Interrupt 
controller detected a lost hardware interrupt. 


This message indicates a hardware or driver problem that could 
degrade performance. 


Unload all drivers and then reload them one at a time to 
determine which driver has a problem. Then contact the vender 
of the driver. 


Set the parameter to Off while you are waiting for a resolution. 
You can set this parameter in the startup.ncf file. 
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Parameter 


Pseudo Preemption Count number 


Global Pseudo Preemption value 


Minimum Service Processes number 


Maximum Service Processes number 


Use to 


Specify the number of times threads are allowed to make file read 
or write system calls before a relinquish is forced. 


Supported values: 1 to 4294967295Default: 40 


If you increase the value too much, the thread could run for its 
lifetime. 


If you decrease the value too much, every read or write call that 
normally would not block might, in fact, end up blocking. 
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Specify whether or not all threads on the server that use the 
Traditional File System will also use pseudo pre-emption. 


Supported values: On, OffDefault: On 


Set this parameter to On if you rely on pseudo pre-emption to 
enforce blocking for threads. 
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Specify the number of service processes that the server will 
retain as it frees unneeded service processes. Service process 
are freed after 5 minutes of inactivity. 


Supported values: 10 to 3000Default: 300 
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Specify the maximum number of service processes that the 
operating system can create. 


You can view the number of service processes in Novell Remote 
Manager or MONITOR. 


Supported values: 50 to 5000Default: 750 


Decrease this parameter value temporarily if the server is low on 
memory. If the server is always low on memory, add more RAM 
for memory. 


Increase this parameter value if the number of service processes 
is at the maximum. 


Increasing this number helps only if more than 20 requests are 
being delayed simultaneously for a disk I/O to be completed. 
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Parameter 


Allow Unencrypted Passwords value 


Multiprocessor Parameters 


Use to 


Control the use of unencrypted passwords. This parameter 
provides for backward compatibility with network services that do 
not support encrypted passwords in the NetWare authentication 
protocol. 


Supported values: On, OffDefault: Off 
We strongly recommend that you retain the default Off setting. 


NetWare 3.1x and later versions support encrypted passwords. If 
servers on your network run earlier versions of NetWare, set the 
value of this parameter to On. 


Warning: Because the use of unencrypted (plaintext) passwords 
represents a significant security risk, you should update your 
servers, utilities, print servers, and NetWare clients to versions 
that support encrypted passwords. If you cannot update or 
upgrade to a newer version and are willing to assume the security 
risk, use the On setting. 
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Multiprocessor parameters allow you to 


¢ Set the threshold for load balancing across multiple processors. 


¢ Start secondary processors automatically on startup. 


¢ Control whether interrupt statistics are removed from memory when a processor is taken 
offline or an interrupt handler is removed. 


Multiprocessor parameters are described in the following table. 


Table 1-11 Multiprocessor Parameters 


Parameter 


System Threshold number 
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Use to 


Adjust the load balancing threshold for multiprocessor servers. 


This number controls the main value used in calculating thread 
shedding for load balancing across multiple processors. The 
optimum value has been preset by Novell. 


Supported values: 0 to 102400Default: 1536 


Important: The default value is the optimum value. We 
recommend that you retain it. If after careful consideration you 
decide to change the setting, experiment only in a nonproduction 
environment. 


You can set this parameter in the startup.ncf file. 


Owning NLM: server.nlm 


Parameter Use to 


Auto Clear Interrupt Statistics value Specify whether interrupt statistics are removed from memory at 
the time a processor is taken offline or an interrupt handler (ISR) 
is removed. 


Supported values: On, OffDefault: On 


To retain per-processor interrupt handler statistics for offline 
processors or to retain the total interrupt contribution from a 
previously loaded handler (ISR), set the parameter to Off. 


This parameter is preferably set in the startup.ncf file. 
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Auto Start Processors value Start secondary processors on startup. 
Supported values: On, OffDefault: On 


On Secondary processors are automatically started when the 
Platform Support Module (PSM) is loaded. 


Off Secondary processors are not automatically loaded on 
bootup. When this is the case, the command START 
PROCESSORS must be used at the console prompt to activate 
secondary processors. 


This parameter is preferably set in the startup.ncf file. 


Owning NLM: server.nlm 


NCP Parameters 
With NetWare Core Protocol™ (NCP™) parameters, you can 


+ Control NCP packets 
¢ Control boundary checking 
+ Assign the NCP Server Packet Signature levels 


For a description of NCP parameters, see the following table. 
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Table 1-12 NCP Parameters 


Parameter 


NCP Exclude IP Addresses values 


NCP Include IP Addresses values 


NCP over UDP values 


NCP TCP keep alive interval number 


Minimum NCP TCP receive window 
to advertise number 
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Use to 


Specify IP addresses over which NCP is disabled. All other IP 
addresses on this server will accept NCP traffic. 


Supported values: None, AllDefault: None 


+ None Indicates that no bound IP addresses on this server 
will disable NCP 


+ All Disables NCP on all bound IP addresses on this server 


Addresses listed in this setting have priority over the values set in 
the "Set NCP Include IP Addresses" command. 


You can set this parameter in the startupfile. 
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Specify IP addresses over which NCP is enabled. All other IP 
addresses on this server will ignore NCP traffic. 


Supported values: None, AllDefault: All 


+ None Disables NCP on all IP addresses 


+ All Enables NCP over all bound IP addresses on this server 
You can set this parameter in the startup.ncf file. 
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Enable or disable NCP over UDP. 
Supported values: On, OffDefault: On (Enable) 
You can set this parameter in the startup. ncf file. 
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Set the delay before TCP keep alive closes idle NCP 
connections. 


Supported values: 0 seconds to 15 hours 59 minutes 53.6 
secondsDefault: 9 minutes 53.2 seconds 


O Never time out idle connections 
You can set this parameter in the startup.ncf file. 
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Set the minimum receive window to advertise on NCP 
connections. 


Supported values: 256 to 16384Default: 4096 
You can set this parameter in the startup.ncf file. 
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Parameter 


NCP TCP receive window number 


Enable UDP Checksums on NCP 
Packets number 


Enable IPX Checksums number 


Enable Task Zero Checkings number 


Use to 

Set the advertised receive window on NCP connections. 
Supported values: 1400 to 65535Default: 23360 

You can set this parameter in the startup.ncf file. 
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Enable checksumming of NCP UDP packets 
Supported values: 0, 1, 2Default: 1 


0 No checksums 1 Checksum if enabled at client 2 Require 
checksums 


You can set this parameter in the startup.ncf file. 
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Enable checksumming of IPX™ packets. 
Supported values: Default: 1 


0 No checksums 1 Checksum if enabled at the client 2 Require 
checksums 


You can set this parameter in the startup.ncf file. 
Owning NLM: ncpipx.nlm 


Enable zero task checking. Enable packet checking for valid use 
of task zero. 


Supported values: On, OffDefault: Off 
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Parameter 


NCP Packet Signature Option 
number 


Level 2 OpLocks Enabled value 


Client File Caching Enabled value 
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Use to 


Control the NCP packet signature level on the server. 
Supported values: 
O Server doesn't sign packets (regardless of the client level) 


1 Server signs packets only if the client requests it (client level is 
2 or higher) 


2 Server signs packets if the client is capable of signing (client 
level is 1 or higher) 


3 Server signs packets and requires all clients to sign packets (or 
logging in will fail) 


Default: 1 


NCP Packet Signature prevents packet forgery on servers and 
clients using NCP by requiring server and client to sign each NCP 
packet. 


Note: Because Packet Signature consumes processor resources 
and slows performance on both client and server, NCP Packet 
Signature is optional. 


After starting the server, you can only increase the level of packet 
signature. To decrease the level, you must add the SET 
command to the startup.ncf file and restart the server. 


You can set this parameter in the startup.ncf file. 
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Allow or disallow level 2 (shared) oplocks. 

Supported values: On, OffDefault: On (Allow) 

You can set this parameter in the startup.ncf file. 
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Allow or disallow the client-side caching of opened files. 
Supported values: On, OffDefault: On (Allow) 

This parameter is also settable in the startup .ncf file. 
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Parameter 


NCP Protocol Preferences value 


NCP File Commit value 


Display NCP Bad Component 
Warnings value 


Reject NCP Packets with Bad 
Components value 


Display NCP Bad Length Warnings 
value 


Use to 


When multiple protocols are supported, specify the order in which 
eDirectory™ selects a protocol to use when communicating with 
other servers in the replica. 


Supported values: IPX, TCP, UDP, noneDefault: None 


For example, the following command instructs eDirectory to try 
TCP first and IPX second when it communicates with another 
server: 


SET NCP PROTOCOL PREFERENCES TCP IPX 


If only one protocol is supported, that protocol is used by 
eDirectory, no matter what values are specified for this 
parameter. 


If multiple protocols are supported but no value is specified for 
this parameter, eDirectory uses the protocols in the order in 
which they are loaded. 
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Control whether applications can flush pending file writes to disk. 
Supported values: On, OffDefault: On 


If the value is set to On, then when a File Commit NCP is issued, 
a file is sent from cache to disk immediately instead of waiting for 
the cache manager to send it to disk later. 
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Control whether NCP bad component alert messages are 
displayed. 


Supported values: On, OffDefault: Off 
You can set this parameter in the startup.ncf file. 
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Specify whether NCP packets that fail component checking are 
rejected. 


Supported values: On, OffDefault: Off 
You can set this parameter in the startup.ncf file. 
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Control whether or not to display NCP bad length alert 
messages. 


Supported values: On, OffDefault: Off 
You can set this parameter in the startup.ncf file. 
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Parameter 


Reject NCP Packets with Bad 
Lengths value 


Maximum Outstanding NCP 
Searches number 


Allow Change to Client Rights value 


Allow LIP value 


Use to 


Specify whether to reject NCP packets that fail boundary 
checking. This parameter can be used as a debugging tool. 


Supported values: On, OffDefault: Off 
You can set this parameter in the startup.ncf file. 
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Specify the maximum number of NCP directory searches that can 
be processed simultaneously. 


Supported values: 10 to 1000Default: 51 
Normally, only one NCP directory search occurs at a time. 


Increase the default only if you use applications that support 
multiple outstanding directory search operations and you have 
problems with corrupted or invalid directory information. 
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Control whether a job server can assume the rights of a client for 
NCP packet signatures. 


Supported values: On, OffDefault: On 


Note: Some job servers and third-party applications can't 
function without changing to client rights. 


Using Off might prevent some job servers from getting access to 
the files they need, but it prevents the forging of a packet through 
the job or print server. 


You can set this parameter in the startup.ncf file. 
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Set Large Internet Packet (LIP) support. 

Supported values: On, OffDefault: On 

You can set this parameter in the startup.ncf file. 
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Novell Storage Services Parameters 


The following are the default settings in NetWare 6.5 for the NSS file system SET parameters. 


Common File System SET Parameters for NSS and Traditional File Systems Default Value 


NSS Auto Locks HFS CD-ROM Disc in device Off 
NSS Auto Update CDHFS Volume Objects To NDS Off 
Mount ISO 9660 multi disc set as one CD9660 volume Off 
NSS Auto Locks CD-ROM Disc in device Off 
NSS Auto Update CD9660 Volume Objects To NDS Off 
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Common File System SET Parameters for NSS and Traditional File Systems 
Emulate Classic NetWare Directory Quotas 

NSS Work To Do Count 

(This parameter can be set only in the nssstart.cfq file.) 
NSS Maximum Cache Balance Buffers Per Session 

NSS Cache Balance Timer 

NSS Cache Balance Percent 

NSS Cache Balance Enable 

NSS Buffer Flush Timer 

NSS Minimum OS Cache Buffers 

NSS Minimum Cache Buffers 

NSS File Flush Timer 

NSS Closed File Cache Size 

(This parameter can be set only in the nssstart.cfq file.) 
NSS Open File Hash Shift 

NSS Auth Cache Size 

(This parameter can be set only in the nssstart.cfq file.) 
NSS ASCII Name Cache Enable 

(This parameter can be set only in the nssstart.cfq file.) 
NSS Name Cache Enable 

(This parameter can be set only in the nssstart.cfq file.) 
NSS Name Cache Size 

NSS Low Volume Space Alerts 

NSS Low Volume Space Warning Reset Threshold 

NSS Low Volume Space Warning Threshold 


Power Management Parameters 


Default Value 


Off 
50 


1024 


16 
1024 


On 


On 


2111 


On 


15 
10 


Power Management parameters let you control the behavior of the Power button and the Down and 


Reset options on a server running the ACPI power management driver. 
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Table 1-13 Power Management Parameters 


Parameter 


Power Button Mode number 


Power Down Delay time 


Server Power Down Options value 


228 NW 6.5 SP8: Utilities Reference 


Use to 


Control the behavior of the Power button on a server running the 
ACPI power management driver. 


Supported values: 0, 1Default: 1 


+ 0 Disables the Power button 
+ 1 Enables the Power button for shutdown 


This setting uses the Power Down Delay setting before 
shutting down and powering off the server. 


You can set this parameter at any time. The changes will be 
saved (persistent). 


You can set this parameter in the startup.ncf file. 





WARNING: Without the ACPI power management driver loaded, 
pressing the Power button immediately removes power from the 
system. 


Pressing and holding the Power button for four seconds removes 
system power regardless of this setting. 
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Control the fixed delay on a server running the ACPI power 
management driver before the server begins shutting down in 
response to pressing the Power button or entering SHUTDOWN 
at the System Console prompt. 


If you need to cancel a pending shutdown, you must enter 
SHUTDOWN ABORT before the delay time expires. 


Supported values: 0 seconds to 10 minutesDefault: 30 seconds 


You can set this parameter at any time. The changes will be 
saved (persistent). 
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Control the behavior of the DOWN and RESTART SERVER 
console commands on a server running the ACPI power 
management driver, . 


Supported values: On, OffDefault: On 


+ On Executing DOWN shuts down and powers off the server. 
Executing RESTART SERVER shuts down the server and 
performs a system reset. 

+ Off Executing DOWN shuts down server and leaves the 


power on. Executing RESTART SERVER shuts down and 
then restarts the server. 


You can set this parameter at any time. The changes will be 
saved (persistent). 
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Service Location Protocol Parameters 


The service location protocol parameters define how SLP locates and distributes information about 
services that are available on the network. 


For descriptions of service location protocol parameters, see the following table. 


Table 1-14 Service Location Protocol Parameters 


Parameter 


SLP Exclude IP Addresses value 


SLP Include IP Addresses value 


SLP Agent IP Address value 


SLP API Handicap value 


Use to 


Specify IP addresses over which SLP is disabled. All other IP 
addresses on this server will accept SLP traffic. 


Supported values: None, AllDefault: None 


+ None Indicates that no bound IP addresses on the server 
will disable SLP. 


+ All Disables SLP on all bound IP addresses on the server. 
Addresses listed here have priority over the Set SLP Include 
IP Addresses command. 


This parameter can be set in the startup. ncf file. 
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Specify IP addresses over which SLP is enabled. All other IP 
addresses on this server will ignore SLP traffic. 


Supported values: None, AllDefault: None 


+ None Indicates that SLP is disabled on all IP addresses. 


+ All Enables SLP over all bound IP addresses on this server. 
This parameter can be set in the startup.ncf file. 
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Specify the IP address of the SLP SA/DA on the server. 
Supported values: First, FollowDefault: First 


+ First Use the first bound NON-Excluded IP address. 


+ Follow Use the IP address of the received SA/DA service 
request. 


This parameter can be set in the startup.ncf file. 
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Set the maximum number of UA requests before SLP starts 
slowing them down. 


Supported values: 1 to 100000Default: 50 
This parameter can be set in the startup.ncf file. 


Owning NLM: slp.nlm 


Utilities 


229 


Parameter 


SLP Maximum Memory Percent 


number 


SLP Cache Timeout number 


SLP Enable UA Multicast values 


SLP Register nwserver values 


SLP nwserver NLM names values 


SLP Maximum WTD number 


SLP Maximum WTD Queue number 
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Use to 


Set the maximum memory percentage that sends can allocate 
before rejecting future allocations and purging UA cache. 


Supported values: 5 to 70Default: 15 
This parameter can be set in the startup.ncf file. 
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Specify how long (in seconds) the UA cache will retain 
information. Zero disables cache. 


Supported values: 0 to 4294967295Default: 120 
This parameter can be set in the startup.ncf file. 
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Enable or disable the use of User Agent General Multicast 
packets. Disabling requires full dependancy on the directory 
agent. 


Supported values: On, OffDefault: On 

This parameter can be set in the startup.ncf file. 
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Enable or disable the nwserver.novell service registration. 
Supported values: On, OffDefault: On 

This parameter can be set in the startup.ncf file. 
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Enable or disable the nwserver.novell service to include NLM 
names as an attribute. 


Supported values: On, OffDefault: Off 

This parameter can be set in the startup.ncf file. 
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Specify the maximum number of controlled work-to-do threads. 
Supported Values: 1 to 256Default: 32 

This parameter can be set in the startup.ncf file. 
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Specify the maximum number of work-to-do threads allowed to 
be queued before dropping packets. 


Supported Values: 0 to 1048575Default: 15000 
This parameter can be set in the startup.ncf file. 
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Parameter 


SLP Reset values 


SLP Scope List number 


SLP Static Scope List number 


SLP Close Idle TCP Connections 
Time value 


SLP DA Heart Beat Time value 


SLP DA Event Timeout number 


Use to 


Force SA to send new service registers. Force DA to send DA 
Advertise. Flag will be reset to off. 


Supported values: On, OffDefault: Off 

This parameter can be set in the startup. ncf file. 
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Specify scope list using a comma-delimited string. 
Max Length: 185Default: ... 

This parameter can be set in the startup. ncf file. 
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Use SLP Scope List as the only source of scopes. The SA/UA will 
only use scopes listed in the SLP Scope List. Otherwise, the SA 
will use scopes listed in the SLP scope list and filtered scopes 
from slp.cfg and the UA will use scopes listed in the SLP 
scope list, filtered scopes from slp.cfg, and scopes discovered 
from DAs. 


This parameter has no effect when SLP Scope List is not set or is 
set to the default. 


Supported values: On, OffDefault: On 
This parameter can be set in the startup. ncf file. 
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Specify the amount of time (in seconds) to wait before idle TCP 
connections should be terminated. 


Supported values: 0 to 86400Default: 300 
This parameter can be set in the startup. ncf file. 
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Specify the amount of time (in seconds) to wait before sending 
the next Directory Agent heartbeat packet. 


Supported values: 0 to 65535Default: 10800 
This parameter can be set in the startup.ncf file. 
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Specify the amount of time (in seconds) to wait before timing out 
Directory Agent packet requests. 


Supported values: 0 to 128Default: 15 
This parameter can be set in the startup.ncf file. 
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Parameter 


SLP MCA Timeout number 


SLP SA Default Lifetime number 


SLP Retry Count number 


SLP Debug number 


SLP Rediscover Inactive Directory 
Agents number 


SLP Multicast Radius number 
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Use to 


Specify the amount of time (in seconds) to wait before timing out 
multicast packet requests. 


Supported values: 0 to 128Default: 16 

This parameter can be set in the startup.ncf file. 
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Specify the default lifetime (in seconds) on service registers. 
Supported values: 129 to 65535Default: 3600 

This parameter can be set in the startup.ncf file. 
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Specify the maximum number of retries. 

Supported values: 0 to 128Default: 3 

This parameter can be set in the startup.ncf file. 
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Enable SLP debug mode. 


+ Bit 0x01 COMM 
+ Bit 0x02 TRAN 
+ Bit 0x04 API 

+ Bit 0x08 SA_DA 
+ Bit0x10 ERR 

+ Bit 0x20 SA 

+ Bit 0x40 UA_DA 


Supported values: 0 to 4294967295Default: 0 
This parameter can be set in the startup.ncf file. 
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Specify the minimum time period (in seconds) that SLP will wait 
to issue service requests to rediscover inactive Directory Agents. 


Supported values: 0 to 86400Default: 60 
This parameter can be set in the startup.ncf file. 
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Specify the multicast radius. SLP v2 is administratively scoped in 
accordance with RFC 2365. 


Supported values: 0 to 255Default: 255 
This parameter can be set in the startup.ncf file. 
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Parameter Use to 
SLP DA Discovery Options number Use multicast DA advertisements. 


+ 1 (0001b) Dynamic discovery via multicast 
2 (0010b) Use DHCP discovery 
4 (0100b) Use static file sys:etc\\slp.cfg 


8 (1000b) Always disable dynamic discovery when DHCP or 
static file bits are set. 


+ 


+ 


+ 


) 
) 
) 
) 


Bits can be added together for multiple values and are specified 
as decimal numbers. 


Example: To enable DHCP discovery and static file discovery, 
you would add 2 and 4 then specify the decimal value 6 (2 + 4 6). 


These bits can be ordered together for multiple values. 
Supported values: 0 to 15Default: 15 
This parameter can be set in the startup. ncf file. 
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SLP MTU Size value Specify the maximum transfer unit size. 
Supported values: 0 to 24682Default: 1450 
This parameter can be set in the startup.ncf file. 
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SLP Broadcast value Use broadcast packets instead of multicast packets. 
Supported values: On, OffDefault: Off 
This parameter can be set in the startup.ncf file. 
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SLP TCP value Use TCP packets instead of UDP packets when possible. 
Supported values: On, OffDefault: Off 
This parameter can be set in the startup. ncf file. 
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Time Parameters 


Time parameters control time synchronization, the timesync.cfg file, and time zone settings to 
ensure that the time reported by all servers is consistent, or synchronized. For more information, see 
the NW 6.5 SP8: Network Time Synchronization Administration Guide. 


For a description of time parameters, see the following table. 
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Table 1-15 Time Parameters 


Parameter 


start of daylight savings time 
date_and_time 


end of daylight savings time 


date_and_time 


daylight savings time offset [+|-] 
hour.minute:second 


timesync configured sources onloff 
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Use to 


Specify a local date and time when the switch to daylight savings 
time should occur. Formats include a simple date and time or 
rules introduced by a open paren "( ". 


For example: April 4 1993 2:0:0 am, (April 4 2:0:0 am), (April 
Sunday < 1 2:0:0 am), or (April Sunday First 2:0:0 am). 


Only rules can reschedule for the next year. You must set both 
the start and end dates before either will be scheduled. 


The settings will not be saved in the NetWare Registry. 
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Specify a local date and time when the switch off of daylight 
savings time should occur. Formats include a simple date and 
time or rules introduced by an open paren "(". 


For example: October 31 1993 2:0:0 am, (October 31 2:0:0 am), 
(October Sunday < 31 2:0:0 am), or (October Sunday last 2:0:0 
am). 


Only rules can reschedule for the next year. You must set both 
the start and end dates before either will be scheduled. 


The settings will not be saved in the NetWare Registry. 
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Specify the offset applied in time calculations when daylight 
savings time is in effect. 


Issuing this command causes UTC time to be recalculated from 
local time. 


The offset applied in time calculations when daylight savings time 
is in effect. The default is +1:00:00 (one hour). Issuing this 
command causes UTC time to be recalculated from local time. 
+0:00:00 to +0:00:00 


Supported values: +0:00:00 to +0:00:00Default: +1:00:00 (one 
hour) 


The settings will not be saved in the NetWare Registry. 
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Specify whether the server listens to the advertising time sources. 


When On, this server does not listen to advertising time sources. 
Instead, it contacts only sources explicitly configured with the 
Time Sources parameter. 


Supported values: On, OffDefault: Off 
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Parameter 


timesync debug flag number 


timesync polling count number 


timesync polling interval number 


timesync reset value 


timesync restart flag 


timesync service advertising onloff 


Use to 


Specify whether Timesync opens or logs a debug screen to view 
or log debug information. 


To enable the debug screen and log it to timesync.log 
(located in sys: \system), use 





set timesync debug=15 
To enable the debug screen only and disable the log, use 


set timesync debug=7 





To disable both the debug screen and logging, use 


set timesync debug=0 





For more information, see Section 1.56, “FLAG,” on page 59. 
Supported values: 0, 7, 15 Default: O 
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Specify the number of time packets to exchange while polling with 
the time provider. 


Supported values: 1 to 1000Default: 3 
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Specifiy the time interval (in seconds) before the next polling 
begins. 


Supported values: 10 to 2678400Default: 600 
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Specify whether Timesync resets the previous internal values and 
reads the new values on the configured server list. 


Supported values: On, Off Default: Off 
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Specify whether Timesync restarts. 
When set to On, Timesync restarts. 
Supported values: On, OffDefault: Off 
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Specify time source advertising. 


When On, this time source advertises itself using SAP/SLP. 
Secondary time servers never advertise. 


Supported values: On, OffDefault: Off 
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Parameter 


timesync synchronization radius 
value_in_seconds 


timesync time adjustment [+|- 
Jhour:minute:seconafat month/day/ 
year hour:minute:second [AM or PM]] 


timesync time source /P_address 


timesync type value 


standard time offset time zone IST 
[Time_offset_from_IST] 
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Use to 


Specify the maximum tolerance (in seconds). 


If the offset is less than this value (in milliseconds), Timesync 
remains in synchronization. 


Supported values: 0 to 2147483647Default: 2000 
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Schedule a time adjustment. Can be issued only from a Single, 
Reference, or Primary type server. 


Single and Reference time servers do not accept adjustments 
from Primary time servers. 


Supported values: A date in the format of [+|-]hh:mm:ss [AT 
[date and time]] or CancelDefault: Six polling intervals or one hour 
(whichever is longer) from now. 


Using the word cancel instead of a date cancels a previously 
scheduled adjustment. 
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Specify that this server contacts the servers in this list as time 
providers. 


Each time server (IP address, DNS name) in this list is separated 
by a semicolon ( ; ). 


For example: 
MyServer:123; 


where the semicolon ( ; ) clears the MyServer list and specifies 
that MyServer is the NetWare (NTP) time source. 


Supported values: A server list (IP address or DNS name, each 
separated by a semicolon) or an empty listDefault: Empty list 
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Specify the Timesync server type. 


Supported values: Single, Reference, Primary, 
SecondaryDefault: Single 
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Offset (in hours) from Universal Time Coordinated (UTC). 


The time zone string indicates the abbreviated name of the time 
zone, the offset from UTC, and the alternate abbreviated time 
zone name to be used when daylight savings time is in effect. 


Issuing this command causes UTC time to be recalculated from 
local time. 


Supported values: On, OffDefault: Off 
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Parameter 


timesync max log file size number 


timesync NTP Client port number 


Time Zone value 


default time server type 
primary|single|secondary|reference 


Traditional File Parameters 


Use to 


Specify the largest size (in KB) of the 
sys:\system\timesync.1og file. 


Supported values: 500 to 1,073,741,824Default: 1048576 
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Specify the port that the NTP Client uses to make an NTP Time 
Request. 


Supported values: 0 (Dynamic Port) and values greater than 
1024 up to 32768Default: 0 
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Specify a time zone string that indicates the abbreviated name of 
the time zone. 


Supported values: The offset from Universal Time Coordinated 
(UTC), and the alternate abbreviated time zone name to be used 
when daylight savings time is in effect. Default: <> 


Issuing this command causes UTC time to be recalculated from 
local time. 
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Specify the default time synchronization server type. 


This parameter can be overridden by separate time 
synchronization parameters. 


Supported values: Secondary, Primary, Reference, Single Can 
be overridden by separate time synchronization parameters. 


Default: Secondary 
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Traditional file parameters now contain parameters that were previously designated as Directory 
Caching, File Caching, Error Handling, File System, Locks, and Transaction Tracking 


File Caching Parameters for the Traditional File System 


File caching allows faster access to frequently used files by holding a file (or a portion of it) in disk 
cache memory. Files being read from or written to are kept in file cache buffers. When the requested 
data is already in cache, disk reads are unnecessary. 


The number of files kept in memory depends on the number of file cache buffers allowed. This is 
determined by the amount of disk cache memory available and the value of the Minimum File Cache 


Buffers parameter. 


Disk cache memory not only speeds up access to file data, it is also used to cache portions of the 
eDirectory database. If you want to tune your NetWare server in general, or eDirectory in particular, 
tune the file caching parameters. The key to optimizing cache utilization is to monitor both Long 
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Term Cache Hits and LRU Sitting Time statistics. Both parameters are found in MONITOR's 
Available Options > Disk Cache Utilization. (File caching parameters can also be set in 
MONITOR's Available Options > Server Parameters.) 


File caching and directory caching work together, however. In tuning the server, directory caching 
and file caching need to be balanced for maximum performance. See “How Directory Caching and 
File Caching Work Together” on page 240. 


Remember also that the file and directory caching parameters in SET apply only to NetWare servers 
using the Traditional File System. In contrast, the NSS file system provides improved resource use, 
requiring less memory to mount multiple volumes. 


For information about NSS directory caching parameters, see “Overview of NSS” in the NW 6.5 
SP8: NSS File System Administration Guide. 


For a description of file caching parameters, see the following table. 
Table 1-16 File Caching Parameters for the Traditional File System 


Parameter Use to 


Read Ahead Enabled value Specify whether the system conducts background reads to cache 
in advance of blocks soon to be requested. 


Supported values: On, OffDefault: On 


Read-aheads can happen only when sequential file accesses are 
occurring. 
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Read Ahead LRU Sitting Time Specify the minimum cache LRU (least recently used) sitting time 
Threshold number for read-aheads to take place. 


Supported values: 0 seconds to 1 hourDefault: 10 seconds 
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Minimum File Cache Buffers number Set the minimum number of cache buffers the operating system 
can allow for file caching. 


Supported values: 20 to 2000Default: 20 


All memory not allocated for other processes is given to disk 
cache memory to use for file and directory caching. As memory is 
requested for other processes, the server gives up cache buffers. 


This limit specifies when the server must stop giving file cache 
buffers to other processes. 


If you set the minimum too high, other processes might not be 
able to allocate necessary memory resources. 


For example, a module could fail to load because the server is 
out of available memory. 
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Parameter 


Maximum Concurrent Disk Cache 
Writes number 


Dirty Disk Cache Delay Time time 


Minimum File Cache Report 
Threshold number 


Use to 


Specify the number of write requests for changed file data that 
can be put in the elevator before the disk head begins a sweep 
across the disk. 


Supported values: 10 to 4000Default: 50 


A high number creates more efficient write requests. A low 
number creates more efficient read requests. 


Monitor the number of Dirty Cache Buffers displayed on the 
Cache Utilization Statistics screen in MONITOR or in Novell 
Remote Manager > View Memory Config > File System Cache. 


If this number is above 70 percent of total cache buffers, optimize 
the write speed by increasing this parameter. 
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Specify how long (in seconds) the system keeps a write request 
(that does not fill a cache buffer) in memory before writing the 
request to disk. 


Supported values: 0.1 second to 10Default: 3.3 


Increasing the time makes disk writing more efficient if your users 
make many small write requests. 


Decreasing the time can reduce performance drastically and 
reduces the chances of losing data only slightly. 
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Specify how few cache buffers can be available before the 
operating system warns you that the number of buffers is getting 
low. 


Supported values: 0 to 2000Default: 20 


For example, if the value of the Minimum File Cache Buffers 
parameter is set to 20 and this parameter is set to 25, you are 
warned when all but 45 cache buffers are allocated for other 
processes. 


Regardless of how this parameter value is set, the operating 
system will issue a warning when it reaches the minimum number 
of cache buffers. You receive the following message: Cache 
memory allocator exceeded minimum cache buffer 
left limit. 
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Directory Caching Parameters for the Traditional File System 


Directory caching allows fast access to frequently used directories. A directory cache buffer is a 
portion of NetWare server memory (disk cache memory) that holds entries from the directory table. 


A directory entry stays in a cache buffer as long as it is accessed frequently (default=33 seconds). 
The system can overwrite the directory entry if the allocated directory cache buffers are accessed 


more frequently. 
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Directory caching and file caching work together, however. In tuning the server, directory caching 
and file caching need to be balanced for maximum performance. 


Remember also that the directory and file caching parameters in SET apply only to NetWare servers 
using the Traditional File System. In contrast, the NSS file system provides improved resource use, 
requiring less memory to mount multiple volumes. 


For information about NSS caching parameters, see “Cache Balancing Commands (NetWare)” on 
page 132 and “Overview of NSS” in the NW 6.5 SP8: NSS File System Administration Guide. 


For a description of directory caching parameters, see Table 1-17 on page 241. 


Allocation of Directory Cache Buffers 


When the server boots, the system allocates a minimum number of directory cache buffers 
(default=20). It creates these buffers immediately when it receives a request for a new buffer. 


The server obtains directory cache buffers by removing a minimal set of file cache buffers from the 
file cache during server startup. Additional directory cache buffers are obtained from the file cache 
later on if they are needed. 


When the minimum number of buffers is allocated and another is needed, the system must wait a 
specified amount of time before allocating another buffer. 


If necessary, the system allocates buffers until it reaches the maximum. If enough directory cache 
buffers are allocated and enough memory is available for directory caching, all directory tables can 
be cached in memory. 


How Directory Caching and File Caching Work Together 


As directory cache buffers increase, file cache buffers decrease. Thus, a tradeoff exists between 
directory caching and file caching, and directory caching and file caching must be balanced for 
maximum performance. 


If you adjust the system to use too much memory for directory caching, you can leave too little 
memory for file caching, and vice versa. 


For a description of file caching parameters, see Table 1-16 on page 238. For a description of 
directory caching parameters, see the following table. 
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Table 1-17 Directory Caching Parameters for the Traditional File System 


Parameter Use to 
Dirty Directory Cache Delay Time Specify how long (in seconds) the system keeps a directory table 
time write request in memory before writing it to disk. 


Supported values: 0 to 10Default: 0.5 


Increasing the delay time gives slightly quicker performance but 
increases the probability of the directory tables becoming 
corrupted. 


Decreasing the delay time slightly reduces the chance of 
directory tables becoming corrupted, but can reduce performance 
slightly. 


A setting of 0 reduces performance dramatically. 
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Directory Cache Allocation Wait Time Specify how long the system must wait after allocating a new 
number directory cache buffer before it can allocate another buffer. 


Supported values: 0.1 second to 2 minutesDefault: 2.2 seconds 


During this time, all requests for a new directory cache buffer are 
ignored. 


If the wait time is too low, peak usage requests cause more 
resources than necessary to be allocated to directory caching. 


If the wait time is too high, the system is very slow in allocating 
the directory cache buffers necessary to service the usual 
number of directory requests. 


If directory searches seem slow even after the server has been 
running for 15 minutes, you should decrease this parameter. 
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Directory Cache Buffer Specify how long a directory entry must be cached before it can 
NonReferenced Delay time be overwritten by another directory entry. 


Supported values: 1 second to 1 hourDefault: 5.5 seconds 


Increasing this parameter speeds up directory access. The 
system allocates more directory cache buffers, and a directory is 
more likely to be cached in memory. 


Decreasing this parameter slows directory access but also 
reduces the need for directory cache buffers. 
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Parameter 


Maximum Directory Cache Buffers 
number 


Minimum Directory Cache Buffers 
number 
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Use to 


Specify the maximum number of cache buffers that the system 
can allocate for directory caching. 


Supported values: 20 to 200000Default: 2000 


This parameter keeps the system from allocating too many 
directory cache buffers so that memory is available for other 
server processes. 


Increase this limit if the server responds slowly to directory 
searches. 


Decrease this limit if too much memory is being allocated for 
directory caching. 


If users are warned that the server is low on memory, this 
parameter should be one of the first to be reduced. (Reboot the 
server to return the memory to the cache buffer memory pool.) 


When a directory cache buffer is allocated, the allocation is 
permanent until the server reboots; the buffers don't return to file 
caching when the need for directory cache buffers decreases. 


This parameter can be set in the startup.ncf file. 
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Specify the minimum number of cache buffers that the system 
can allocate for directory caching. 


Supported values: 10 to 100000Default: 500 


The number needs to be high enough that directory searches can 
be done quickly, but no higher than necessary. 


If the system doesn't need the minimum number of directory 
cache buffers, the buffers can't be reallocated to file caching. The 
unneeded portion remains unused. 


If the server responds slowly to directory searches after it is 
booted, monitor the number of directory cache buffers usually 
allocated for directory caching. 


If the number is significantly higher than this limit, consider 
increasing the limit to remove the delay time that normally occurs 
while the server is self-configuring. Use MONITOR to view the 
current statistics. 


This parameter can be set in the startup.ncf file. 


Owning NLM: filesys.nlm 


Parameter 


Maximum Number of Internal 
Directory Handles number 


Maximum Number of Directory 
Handles number 


Use to 


Specify the maximum number of directory handles available for 
internal NLM programs that use connection 0. 


Supported values: 40 to 1000Default: 100 


A directory handle is a version of the directory access rights that 
is held in cache memory. Caching the access rights speeds 
mapping to the rights. 


Connection 0 (zero) is the connection number reserved for use 
by the server itself and by NLM programs operating within the 
server. 


Each time an NLM using connection 0 accesses a file or 
directory, a directory handle is allocated (up to the total specified 
by this parameter). This value represents the total number of 
handles available to be shared by all NLM programs using 
connection 0. 
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Specify the maximum number of directory handles available for 
each connection. 


Supported values: 20 to 1000Default: 20 


A directory handle is a version of the directory access rights that 
is held in cache memory. Caching the access rights speeds 
mapping to the rights. 


Each time a connection accesses a file or directory, a directory 
handle is allocated (up to the total specified by this parameter). 


Owning NLM: filesys.nlm 


File Parameters for the Traditional File System 


+ Three parameters control warnings about volumes that are almost full. 


¢ Three parameters control file purging. File-purging parameters influence other parameters 
which, in turn, control warnings about almost-full volumes. 


All deleted files remain on the disk for a specified minimum amount of time. The system 
calculates a volume's remaining space by subtracting the following from the total space: 


+ Actual files 


+ Salvageable files that can't be purged because their Minimum File Delete Wait Times have 


not expired 


+ One parameter controls the reuse of turbo FATs. 


+ Ten parameters control file compression. 


For a description of file system parameters, see the following table. 
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Table 1-18 File Parameters for the Traditional File System 


Parameter 


Automatically Repair Bad Volumes 
value 


File Delete Wait Time time 


Allow Deletion of Active Directories 
value 


Maximum Percent of Volume Space 
Allowed for Extended Attributes 
percentage 


Maximum Extended Attributes per 
File or Path number 
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Use to 


Specify whether VREPAIR runs automatically on a volume that 
fails to mount. 


Supported values: On, OffDefault: On 
You can set this parameter in the startup.ncf file. 
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Specify when a salvageable file can be purged to create free 
space on a volume. 


Supported values: 0 seconds to 7 daysDefault: 5 minutes 29.6 
seconds 


Set this parameter as high as is useful for your users, but this 
parameter doesn't guarantee that a file remains salvageable. 


The system tries to keep at least 1/32 of available space on the 
volume free for new files. 


This parameter guarantees only that files aren't purged to 
maintain this free disk space. 


Files that haven't met this time limit are purged if the volume is 
full and the system needs space for a user to create a new file. 


When a deleted file remains on the server longer than the File 
Delete Wait Time parameter setting, the system marks the file as 
purgeable. 


When the volume is full of purgeable files and needs free space, 
the oldest purgeable files are purged. 
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Specify whether a directory can be deleted when another 
connection has a drive mapped to it. 


Supported values: On, OffDefault: On 
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Limit the portion of volume space used for extended attribute 
storage. The setting takes effect only when the volume is being 
mounted. 


Supported values: 5 to 50Default: 10 
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Limit the number of extended attributes that can be assigned toa 
file or path (subdirectory). This limit applies to all volumes on the 
server. 


Supported values: 4 to 512Default: 16 
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Parameter 


Purge Files On Dismount value 


Fast Volume Mounts value 


Maximum Percent of Volume Used by 
Directory percentage 


Maximum Subdirectory Tree Depth 
number 


Volume Low Warn All Users value 


Use to 


Have the system purge deleted files on a volume when it is 
dismounted. 


Supported values: On, OffDefault: Off 
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Increase the speed at which volumes are mounted. 
Supported values: On, OffDefault: On 


The operating system checks only the most important fields 
during the mounting process. Use this parameter only if volumes 
were dismounted normally. 


This parameter can be set in the startup.ncf file. 
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Limit the portion of a volume that can be used as directory space. 
Supported values: 5 to 85Default: 13 
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Specify how many levels of subdirectories the system supports. 
Supported values: 10 to 100Default: 25 


This parameter can be set in the startup.ncf or in the 
autoexec .ncf file, or at the server console. 


Increase the number if your applications support trees deeper 
than 25. 


Decrease the number if your applications support only shallow 
tree structures. 


(Some DOS applications can't support more than 10 levels if the 
subdirectories have 11-character names.) 
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Have the system notify users when a volume is almost full. 
Supported values: On, OffDefault: On 


If you choose not to have your server warn users, monitor volume 
statistics at least daily with MONITOR or Novell Remote Manager 
> Volumes > Volume Inventory Report. 
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Parameter 


Volume Low Warning Reset 
Threshold number 


Volume Low Warning Threshold 
number 
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Use to 


Control how much disk space (in blocks) must be freed up before 
a second warning is issued that the volume is almost full. (The 
first warning is controlled by the Volume Low Warn All Users 
parameter.) 


Supported values: 0 to 100000Default: 256 


When a volume is almost full, it can hover at its warning threshold 
as users create and delete files. 


This parameter controls the minimum amount of space that must 
be made available above the threshold before the warning 
message disappears. 


Example: Assume the volume block size is 4 KB, the Volume 
Low Warning Reset Threshold is set to 256, the Volume Low 
Warning Threshold is set to 256, and the volume has less than 1 
MB of free space. 


Given these conditions, the volume must gain at least 1 MB of 
free space (for a total of 2 MB of free space) and then dip below 
the 1 MB threshold before the system sends another warning that 
the volume is almost full. 
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Specify how much free disk space (in blocks) can remain on a 
volume before the system issues a warning. 


Supported values: 0 to 1000000Default: 256 


Consider the following: A block is the minimum space allocated to 
a file; a file can grow only in multiples of the block size. 


The block's physical size is determined when the volume is 
created. A volume can be assigned these block sizes: 4 KB, 8 
KB, 16 KB, 32 KB, or 64 KB. 


For example, if you specify 256 blocks for this parameter and the 
volume's block size is 4 KB, the system warns you that the 
volume is full when about 1 MB of space is left. 


If your volumes are assigned different block sizes, each volume 
has a different amount of free space when the warning is issued. 
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Parameter 


Turbo FAT Re-Use Wait Time time 


Allow Unowned Files To Be Extended 
value 


Auto Mount Mirrored Volume 
Containing Inactive Device value 


Use to 


Specify how long a turbo FAT buffer remains in memory after an 
indexed file is closed. 


Supported values: 0 to 7 daysDefault: 5 minutes 29.6 seconds 


Once the wait-time value has passed, the system can allocate 
the buffer to another indexed file. 


Increase the wait time if 


+ You want the turbo FAT index to remain in memory for long 
periods of time, even when the file is closed. 


+ You frequently reopen the same file after a specific delay 
and know that another file opened during that delay will 
reuse the index. 


Decrease the wait time if you want the memory released 
immediately to service the next file that needs to be indexed. 


When a program randomly accesses a file that contains more 
than 64 FAT entries, the system builds a turbo FAT index for the 
file so that information is accessed quickly. (NetWare indexes any 
randomly accessed file with 64 FAT entries.) 


The system doesn't immediately delete the index from its buffer 
when the file is closed. 


Having the turbo FAT index in memory makes reopening the file 
and accessing information faster. 
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Specify whether files can be modified when the owner has been 
lost or deleted. 


Supported values: On, OffDefault: On 
This parameter can be set in the startup.ncf file. 
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Specify whether to automatically mount a volume detected to 
have a mirrored partition and an inactive device associated with 
it. 


Supported values: On, OffDefault: On 
This parameter can be set in the startup.ncf file. 
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Locks Parameters for the Traditional File System 


Locks parameters control 


+ How many open files each workstation can have 


+ How many open files the system can handle 
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+ How many record locks each connection can have 


+ How many record locks the system can handle 


There are three types of locks: 


¢ File locks secure the file and prevent other stations from accessing it. 


+ Physical record locks control data access by multiple users. They prevent other users from 
accessing or changing a range of bytes (a record) in a file. They are sometimes referred to as 


byte-range locks. 


Physical record locks are enforced by the system. If a user tries to access a range of bytes that is 
physically locked, the user receives an Access Denied error message. 


¢ Logical record locks also control data access by multiple users. The application assigns a name 
to each section of data that needs to be locked. The application then locks this name whenever 


it accesses the data. 


Logical locks are enforced only to the extent that the application checks the name each time it 


needs access to data. 


For a description of locks parameters, see the following table. 


Table 1-19 Locks Parameters for the Traditional File System 


Parameter 


Maximum Record Locks Per 
Connection number 


Maximum File Locks Per Connection 
number 
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Use to 


Control how many record locks a client connection can use at 
one time. (Use MONITOR to view how many record locks each 
connection is using.) 


Supported values: 10 to 100000Default: 500 


Increase the value of this parameter when an application can't 
lock enough records and fails. 


Decrease the value of this parameter if one or more client 
connections are using an excessive amount of server resources. 
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Control how many opened and locked files a client connection 
can use at one time. (Use MONITOR to view how many opened 
and locked files a connection is using.) 


Supported values: 10 to 1000Default: 2500 


Increase the value of this parameter when an application can't 
open enough files and fails. 


Decrease the value of this parameter if client connections are 
using an excessive amount of server resources. 
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Parameter Use to 


Maximum Record Locks number Control how many record locks the operating system can handle. 
(Use MONITOR to view how many record locks each client 
connection is using on that server.) 


Supported values: 100 to 400000Default: 20000 


Increase the value of this parameter if users have problems 
running applications and receive messages indicating that not 
enough record locks are available. 


Decrease the value of this parameter if client connections are 
using an excessive amount of server resources. 


Owning NLM: filesys.nlm 


Maximum File Locks number Control how many opened and locked files the operating system 
can handle. (Use MONITOR to view the number of files that are 
open during peak usage.) 


Supported values: 100 to 2000000Default: 200000 


Increase the value of this parameter if the number of open files is 
near or equal to the default. 


Decrease the value of this parameter to restrict the amount of 
available server resources. 
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Error Handling Parameters for the Traditional File System 


Error handling parameters control the size of error logs and specify what happens when logs exceed 
the specified size. They also control how the server responds to an abend or to an NLM that does not 
unload from a protected address space. 


For descriptions of error handling parameters, see the following table. 


Table 1-20 Error Handling Parameters for the Traditional File System 


Parameter Use to 

Volume Log File State number Control what happens when the vol$log.err file is larger than 
the size specified by the Volume Log File Overflow Size 
parameter. 


Supported values: 


O Leave volSlog.err asis 
1 Delete vol$log.err 
2 Rename volSlog.err 


Default: 1 
You can set this parameter in the startup. ncf file. 
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Parameter Use to 


Volume TTS Log File State number Control what happens when the tts$log-.err file is larger than 
the size specified by the Volume TTS Log File Overflow Size 
parameter. 


Supported values: 


O Leave tts$log.err asis 
1 Delete tts$log.err 
2 Rename tts$log.err 


Default: 1 
You can set this parameter in the startup. ncf file. 
Owning NLM: filesys.nlm 


Volume Log File Overflow Size Specify the maximum size of the volS$log.err file before the 
number action specified by the Volume Log File State parameter occurs. 


Supported values: 65536 to 4294967295Default: 4194304 
You can set this parameter in the startup.ncf file. 
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Volume TTS Log File Overflow Size Specify the maximum size of the tts$log.err file before the 
number action specified by the Volume TTS Log File State parameter 
occurs. 


Supported values: 65536 to 4294967295Default: 4194304 
You can set this parameter in the startup.ncf file. 
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Transaction Tracking Parameters for the Traditional File System 
+ A transaction is a set of write operations that must be completed together to maintain file and 
database integrity. 


¢ Write operations consist not only of data and data records, but also of changes to the index and 
the key structures that are important to an application's continual operation. 


¢ Transaction Tracking System™ (TTS™) software guarantees that a transaction is written to 
disk in its complete form or is backed out if incomplete. This ensures database integrity in case 
a failure occurs before a transaction is completed. 


For a description of transaction tracking parameters for the Traditional File System, see the the 
following table. 
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Table 1-21 Transaction Tracking Parameters for The Traditional File System 


Parameter 


Auto TTS Backout Flag value 


TTS Abort Dump Flag value 


TTS UnWritten Cache Wait Time time 


TTS Backout File Truncation Wait 
Time time 


Use to 


Specify whether a server with transactional files will automatically 
back out of incomplete transactions when the server is restarted. 


Supported values: 


On The server backs out incomplete transactions when booting 
Off The server waits for you to answer a prompt before it backs 
out of transactions 


Default: On 


You must set this parameter in the startup.ncf file. You 
cannot set the parameter at the command line. 
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Specify whether a file is created to log transactional backout data. 
Supported values: 


On The information is saved in tts$log.err Off The 
information backed out is not saved 


Default: Off 


If the parameter is set to On, the backed-out information is written 
to file ttsSlog.err on volume sys:. You can print the file or 
view it with a text editor. 
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Specify how long a block of transactional data can be held in 
memory. 


Supported values: 11 seconds to 10 minutes 59.1 seconds 
Default: 1 minute 5.9 seconds 


Some blocks of transactional data wait for other transactional 
blocks to be written first. 


If one of these blocks reaches its maximum time limit, other write 
requests are held up and this block is written to disk. 
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Specify how long allocated blocks remain available for the TTS 
backout file when these blocks are not in use. 


Supported values: 1 minute 5.9 seconds to 1 day 2 hours 21 
minutes 51.3 seconds 


Default: 59 minutes 19.2 seconds 
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Additional Information 


Topic See 


Using Novell Remote Manager to set Server Parameters option in the NW 6.5 SP8: Novell Remote 


server parameters Manager Administration Guide. 

Using MONITOR to set server Server Parameters option in Section 1.94, “MONITOR,” on 
parameters page 102. 

Improving server performance NW 6.5 SP8: Server Operating SystemAdministration 


Guide“Optimizing the NetWare Server” in the NW 6.5 SP8: 
Server Operating SystemAdministration Guide 


Editing .ncf files “Using Server Batch Files” in the NW 6.5 SP8: Server Operating 
SystemAdministration Guide 

Time synchronization and the NW 6.5 SP8: Network Time Synchronization Administration 

timesync. cfg file Guide. 


1.155 Showscreen 


Purpose 


Use this command at the System Console prompt to restore a screen that has been hidden by the 
Hidescreen (page 67) command. 


You can also restore a screen by pressing Ctrl+Esc to view the Current Screens list and entering the 
number for the screen you want to restore. Hidden screens are indicated by an asterisk before the 
screen name in the Current Screens list. 


Syntax 





SHOWSCREEN screen name 











Examples 


To restore the Monitor screen after it had been hidden, enter 











SHOWSCREEN netware 6 console monitor 





1.156 SHUTDOWN NETWORK INTERFACE 


Purpose 


Use this command at the System Console prompt to shut down a logical board without removing its 
resources. (A logical board is an instance of one frame type associated with one LAN driver.) 


After you shut down the logical board, you can restart the board, if needed, without reloading and 
binding the LAN driver. See *** 'RESET NETWORK INTERFACE ' on page 170 ***. 
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Syntax 





SHUTDOWN NETWORK INTERFACE board number | board name 














Parameter Use to 


board_number Specify the logical board number. Find the logical board number in 
MONITOR by selecting LAN/WAN Drivers and highlighting the driver 
name. The information window at the top of the screen displays 
information about the driver, including Logical Board Number. 


board_name Specify the logical board name. A name can be assigned to a logical 
board when the board is loaded using the LOAD command. If no name 
was assigned to the board, use the logical board number. 


1.157 SPEED 


Purpose 


Use this command at the System Console prompt to display the speed at which the processor is 
running. 





TIP: The CPUCHECK command provides additional information as well as processor clock speed. 
See *** 'CPUCHECK' on page 39 ***, 





Syntax 





SPEED 











About Processor Speed 


+ Processor speed rating is determined by 
+ Processor clock speed (90 MHz, 100 MHz, 200 MHz, 233 MHz, etc.) 
+ Processor type (80486, Pentium*, Pentium Pro, Pentium II, etc.) 
+ Number of memory wait states (0, 1, 2, etc.) 


+ If your computer has a slower rating than you expected, use SPEED to check the processor's 
speed rating. 


For example, entering SPEED for a Pentium II processor running at 333 MHz got the following 
rating: 


Processor speed: 26288 
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+ Some computers have an Auto or Common processor speed mode that can reduce the clock 
speed to as little as 6 MHz. 


+ For NetWare® 6 or later operation, the processor or processors should be set to the highest 
speed. If your machine has a slower rating than expected, check the processor speed setting. 
For instructions on how to set the processor speed, see your computer's documentation. 


1.158 SPFCON 


Purpose 


The SPFCON utility enables you to monitor Sequenced Packet Exchange™ (SPX™) spoofing 


statistics. 


Spoofing is the process of preserving the transport end point connection by imitating keep alive 
packets and responding to watchdog request packets without passing this traffic across on-demand 


WAN links. 


Using SPX spoofing can help you maintain lower costs over on-demand WAN links. 


1.159 SPXCONFG 


Purpose 


Use at the server console to configure certain SPX™ parameters. 





NOTE: These parameters can also be configured from the INETCFG utility. 





Syntax 


[LOAD] SPXCONFG [option[=value] ] 


Parameter 


(no parameter) 


option 


value 


SPXCONFG Options 


Option 
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Use to 


Load SPXCONFG and display configuration menu. 


Replace option with any available option. See “SPXCONFG Options” on 
page 254. 


Specify a numerical value for an option. 


For information on setting these values, see *** 'INETCFG' on page 71 


kkk 


Use to 


Specify SPX Watchdog Abort timeout (in ticks). 
Specify SPX Watchdog Verify timeout (in ticks). 


Option Use to 


W= Specify SPX Ack Wait timeout (in ticks). 

R= Specify SPX Default Retry count. 

S= Specify maximum concurrent SPX sessions. 

Q=1 Specify quiet mode (suppresses display of changed settings). 
H Display SPXCONFG help screen. 


l= Specify IPX™ maximum socket table size. 


Using SPXCONFG 


+ You can use SPXCONFG in your autoexec.ncf file, as a console command, as a menu utility, 
or as a configuration file that is invoked by INETCFG. 


¢ Ifyou don't specify a parameter, the following menu appears: 


SPX Configuration Control Program 


1. SPX Watchdog Abort timeout 540 


2. SPX Watchdog Verify timeout 54 


3. SPX Ack wait timeout 108 


4. SPX Default Retry count 10 


5. Maximum concurrent SPX sessions 2048 





6. IPX maximum socket table size 1200 


You can then select parameters to change. 
+ SPXCONFG changes the configuration of SPX as well as the STREAMS-based SPXS 
(SPXID. 


+ If you enabled TCP/IP or AppleTalk* on the server, you can use either INETCFG or 
SPXCONFG to set SPX parameters. 


When you set the parameters using INETCFG, a load line for SPXCONFG is automatically 
added to the netinfo.cfg file so it runs each time you bring up the server. 


Utilities 255 


+ If you have only IPX/SPX™ enabled on the server (and not TCP/IP or AppleTalk) and you 
want to use the SPXCONFG parameters each time you boot the server, place the following 
command in your autoexec.ncf file: 


[LOAD] [path]SPXCONFG [option[=value] ] 


Examples 


To set SPX options to 1000 ticks for the SPX Watchdog Abort timeout and suppress the display of 
changed settings, type 


[LOAD] SPXCONFG A=1000 Q=1 


Additional Information 


Topic See 

Setting SPX parameters with INETCFG Section 1.65, “INETCFG,” on page 71 
1.160 SPXS 

Purpose 


Use at the server console to provide STREAMS-based SPX™ protocol services. 


Syntax 


[LOAD] [path]SPXS [LDFILE = [path] filename[ext] ] 





Parameter Use to 
path Specify the path to SPXS if you moved it from the default directory. 


LDFILE = [path]\filename[.exf] Load the data file that contains the SPX timer defaults and physical 
packet size tables. 


If you don't specify a filename, SPXS sets the parameters defined in the 
ipxspx. cfg file. 


If you don't specify a file extension, the default is . cfg. 


Using SPXS 


+ When you load SPXS, the parameters in the ipxspx. cfg file are set, unless you specify an 
alternate configuration filename. 





NOTE: The ipxspx.cfg file is modified from the INETCFG utility when you set SPX/IPX 
parameters. 
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+ You can create multiple configuration files in addition to ipxspx.cfg. Use this feature if you 
frequently alternate between two or more IPX/SPX configurations. 


To create multiple configuration files, copy the IPxSPx.cFc file to a new filename 
(ipxspx2.cfg, for example). Then you can change the ipxspx.cfg file (by using INETCFG) 
and still preserve the original configuration in the ipxspx2.cfg file. 


¢ To load a configuration file other than the default ipxspx.cfg file, use the LDFILE option. 


For example, if you have a second configuration file called ipxspx2.cfg, you can load that 
configuration by typing 


[LOAD] SPXS LDFILE = IPXSPX2 
+ When you load SPXS, STREAMS is autoloaded. 





Additional Information 


Topic See 

Setting SPX parameters using SPXCONFG Section 1.159, “SPXCONFG,” on page 254 
Setting SPX parameters using INETCFG Section 1.65, “INETCFG,” on page 71 
1.161 START PROCESSORS 

Purpose 


Use this command at the System Console prompt to start one or more secondary processors when 
the server is running on a multiprocessor computer. 





NOTE: Because NetWare® is running on processor 0, the boot processor, START PROCESSORS 
affects only secondary processors. 





Syntax 


START PROCESSORS [n...] 





Parameter Use to 
(no parameters) Start all secondary processors. 
n... Specify by processor number the secondary processors to start. 
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Using START PROCESSORS 
¢ To bring a specific secondary processor online, enter at the console prompt: 


START PROCESSORS 1 





A confirmation message is displayed: 





Processor 1 is ONLINE. 


¢ To bring all secondary processors online, enter at the console prompt: 


START PROCESSORS 





A confirmation message is displayed: 


Processor 1 is ONLINE. 











Processor 2 is ONLINE. 























Processor 3 is ONLINE. 





¢ Ifyou choose to start secondary processors when NetWare boots, use Set Auto Start Processors 
= Off in the startup.ncf file (see “Multiprocessor Parameters” on page 220). 


+ To stop secondary processors, see Section 1.162, “STOP PROCESSORS,” on page 258. 


¢ For more information, see “Starting and Stopping Processors” in the NW 6.5 SP8: Server 
Operating SystemAdministration Guide. 


1.162 STOP PROCESSORS 


Purpose 


Use STOP PROCESSORs at the server console prompt to stop one or more secondary processors in 
a multiprocessor computer. 





NOTE: Because Processor 0, the boot processor, cannot be taken offline while the server is running, 
STOP PROCESSORS affects only secondary processors. 





Syntax 


STOP PROCESSORS [n...] 





Parameter Use to 
(no parameters) Stop all secondary processors. 
n... Specify by number the secondary processors to stop. 
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Using STOP PROCESSORS 


Run the DISPLAY PROCESSORS command before stopping a secondary processor to determine 
the processor's status and its number. (See *** 'DISPLAY PROCESSORS' on page 49 ***.) 


When you stop a processor, the threads that were running on the processor are automatically 
migrated to another processor. 


If you run STOP PROCESSORS without specifying the identifying number or numbers of the 
processors, all secondary processors will be stopped. 


For more information, see “Starting and Stopping Processors” in the NW 6.5 SP8: Server Operating 
SystemAdministration Guide. 


Examples 


+ To stop secondary processors | and 3, enter 


STOP PROCESSORS 1 3 





A confirmation message is displayed: 


Processor 1 is OFFLINE. 
Processor 3 is OFFLINE. 














+ To start secondary processors , see *** "START PROCESSORS' on page 257 ***. 


1.163 SWAP 


Purpose 


Use this command at the System Console prompt to display information about swap files, to add or 
delete swap files, and to specify the parameters of swap files. 


Syntax 

















SWAP [ADD vol_name [parameter = value]] [DEL vol_name] [PARAMETER vol_name 
parameter = value] 


Parameter Use to 


(no parameter) Display a screen containing information about swap files. 
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Parameter Use to 


ADD vol_nameparameter = Create a swap file on the designated volume. 

value 
You can specify the following optional parameters when you create a 
swap file: MIN=, MAX=, and MIN FREE=. 


These parameters specify the minimum and maximum size of the swap 
file and the minimum free space that must be left on the volume. Values 
are in millions of bytes. 


If parameters are not included, the following default values are used: 
MIN = 2 

MAX = Free volume space 

MIN FREE = 5 


DEL vol_name Delete a swap file from the designated volume. 





IMPORTANT: If you are using protected address spaces, the Novell® 
JVM for NetWare® product, or any other application that uses virtual 
memory, be sure to keep at least one swap file. 





By default a swap file is created on the Sys volume whenever you start 
the server. If you do not want a swap file on Sys, place the SWAP DEL 
command in the startup .ncf file before the command to mount 
volumes. 


PARAMETER = vol_name Change the parameter values for a swap file on the designated volume. 


parameter = value 
You can specify the following parameters: MIN=, MAX=, and MIN 


FREE=. 


These parameters specify minimum and maximum size of the swap file 
and the minimum free space that must be left on the volume. Values are 
in millions of bytes. 


Using SWAP 


+ Ifa swap file is being used when it is deleted, then the swapped data is moved to another swap 
file. If there is no other swap file, an error message is displayed and the file is not deleted. 


+ You can create one swap file per volume. The swap file for the Sys volume is created by 
default; you can delete it if necessary. 


+ Data moved to disk by virtual memory will be stored in any available swap file; it does not 
matter which volume the swap file is on. Generally, you will place swap files on the fastest 
volume or the one with the most available space. 


+ You can add a swap file to a volume by executing the SWAP ADD command, even if the 
volume is not mounted. Once you've added the swap file, the file will be created when you 
mount the volume. 


+ When you dismount a volume, the swap file is deleted. To keep a swap file on that volume, you 
must create the swap file again. The exception is the sys: volume swap file, which is created 
by default. For convenience, place the commands to create swap files into the autoexec. ncf 
file so the files will be created each time the server is started. 


+ Swap files are dynamic; they change size as data is swapped in and out of memory. 
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Additional Information 


Topic See 

Other options for managing the Swap files in “Viewing Memory Configurations” in the NW 6.5 
NetWare SP8: Novell Remote Manager Administration Guide 
Virtual Memory “Virtual Memory” in the NW 6.5 SP8: Server 


Memory Administration Guide 


Using swap files “Using Swap Files” in the NW 6.5 SP8: Server 
Memory Administration Guide 


1.164 TCPCON 


Purpose 
Use at the server console to 


+ Monitor activity in the TCP/IP network segments of your internetwork 


¢ View configuration and statistics information about the following TCP/IP protocols: IP, ICMP, 
UDP, TCP, OSPF, and EGP 


+ View IP routes known to a TCP/IP node 
+ View network interfaces supported by a TCP/IP node 
+ Access the trap log maintained by SNMPLOG (local systems only) 


+ Use Simple Network Management Protocol (SNMP) over TCP/IP or IPX™ to access TCP/IP 
information in any remote protocol stack supporting the TCP/IP Management Information 
Base (MIB) 


Syntax 


[LOAD] TCPCON 


Using TCPCON 


+ By default, TCPCON monitors and gathers information from the local NetWare® TCP/IP 
node. 


You can, however, access another TCP/IP node on your internetwork if you know the symbolic 
hostname or host IP address of that node. 


+ When you load TCPCON, the TCPCON main screen appears. 
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Figure 1-9 TCPCON Main Screen 








P ole 3.00 





Host: Local System 


Uptime: © Days 18 Hours 12 Min 
System: Novell NetWare v3.11 < 


IP Received: 3 
IP Sent: 4 


¢ The top of the main screen displays a summary of statistics for the selected host, as follows: 


Field 


Host 


Uptime 


System 


IP Received 


IP Sent 


IP Forwarded 


TCP Received 
TCP Sent 


TCP Connections 


Explanation 


Symbolic host name or IP address of the selected TCP/IP host (or 
server name if accessing a remote node using IPX™) being queried. 
This is the host specified in SNMP Access Configuration in the 
Available Options menu. 


Amount of time that has elapsed since the selected host was last 
initialized. 


Brief description of the selected host. 


Number of IP datagrams received from all interfaces, including those 
received in error. 


Number of datagrams sent to IP for transmission. This number does 
not include datagrams forwarded by this host. 


Number of IP packets forwarded from one node to another. This field 
displays the value Disabled if this host is not configured to be an IP 
router. 


Number of TCP segments received, including those received in error. 


Number of TCP segments sent, excluding those containing 
retransmitted data. 


Number of currently established TCP connections. 


¢ The Available Options menu on the main screen allows access to additional features of 


TCPCON, as follows: 


Option 

SNMP Access Configuration 
Protocol Information 

IP Routing Table 


Statistics 


262 NW 6.5 SP8: Utilities Reference 


Use to 

View and modify TCPCON options. 

View protocol information for the selected host. 
View IP routers known to the selected host. 


View TCP/IP statistics. 


Option Use to 


Interfaces View the network interfaces supported by the selected host. 
Display Local Traps View the local SNMP trap log maintained by snmplog.n1m. 
Purpose 


Use this command at the System Console prompt to record NetWare® configuration information. 


Syntax 





[LOAD] TECHWALK [console NLM name] 


Parameter Use to 


(no parameter) Record configuration information for the NetWare MultiProtocol Router 
3.1 INETCFG NLM™ program. 


console_NLM_name Record configuration information for the specified NLM program. 


Using TECHWALK 


TECHWALK saves the configuration information for INETCFG (or the specified NLM program) to 
a file named sys:etc\techwalk.out. All enabled items and summary lists are recorded. 


You might prefer to exit INETCFG (or the specified NLM program) before you run TECHWALK. 
Running TECHWALK takes from 5 to 60 minutes, depending on your configuration and the 
network traffic, and dedicates your machine to the process during that period. 


1.166 TIME 


Purpose 
Use this command at the System Console prompt to display 


+ Date and time kept by the NetWare® server's clock 
+ Daylight saving time status 


¢ Time synchronization information 


Syntax 


TIME 





Using TIME 


When you execute TIME, information similar to the following appears on the console screen. 





NOTE: The output is formatted according to your locale configuration. 





Utilities 


263 


Figure 1-10 TIME Output 


SALES: time 
Time zone string: "MST7MDT" 
DST status: OFF 
DST start: sunday, April 4, 1993 2:00:00 am MST 
DST end: Sunday, October 31, 1993 2:00:00 am MDT 
Time synchronization is active. 
Time is synchronized to the network. 

Monday, June 11, 1993 7:06:59 pm UTC 

Monday, June 11, 1993 12:06:59 pm MST 


1.167 TIMESYNC 


Purpose 


Use at the server console to monitor the internal time on a server to ensure that the time reported by 
all servers across the network is consistent, or synchronized. 


TIMESYNC autoloads when the server boots. Under very few circumstances will you ever load or 
unload TIMESYNC. You may, however, want to load TIMESYNC to use an alternate configuration 
(.c£g) file. 


Syntax 


[LOAD] [path] TIMESYNC 





Parameter Use to 
path Specify the path to timesync.n1m if you moved it from the default 
directory. 


You can set TIMESYNC parameters in the configuration file (timesync.cfg) or with the SET 
utility. 


Additional Information 


Topic See 
Setting time synchronization parameters SET “Time Parameters” on page 233. 
Network time synchronization “Guidelines for Time Synchronization” in the NW 


6.5 SP8: Network Time Synchronization 
Administration Guide 


1.168 TLI 


Purpose 


Use at the server console to provide Transport Level Interface (TLI) communication services. 
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Syntax 


[LOAD] [path]TLI 


Parameter Use to 
path Specify the path to tli .nlm if you moved it from the default directory. 
Using TLI 


¢ To use TLI, you must have one or more protocol service modules loaded, such as SPXS or 
IPXS. 


+ TLI also requires STREAMS, CLIB, and CLIB-related modules and autoloads them if they are 
not already loaded. 


1.169 TPING 


Purpose 


Use this command at the System Console prompt to send an Internet Control Message Protocol 
(ICMP) echo request packet to an IP node on your internetwork. 


TPING is a command line utility that determines whether an IP target node on your internetwork is 
reachable. 


Syntax 


[LOAD] TPING host [packet_size [retry count] ] 


Parameter Use to 

host Specify the symbolic host name or IP address of a TCP/IP system on the 
network. 

packet_size Specify the size, in bytes, of the ICMP packet. 

retry_count Specify the number of times you want to resend an ICMP packet to the 


host system if a reply is not received (default = 5). 


Using TPING 


TPING sends an ICMP echo request packet to the IP target node. If the target node receives the 
request packet, it sends back a reply packet. 


If TPING doesn't receive a reply, it resends the request packet the specified number of times. 


When TPING receives a reply, it stops sending requests and displays a message indicating that the 
target node is reachable. (If it doesn't receive a reply, TPING also notifies you.) 
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1.170 TRACK OFF 


Purpose 


Use this command at the System Console prompt to prevent the server from displaying the RIP 
Tracking Screen. This screen displays Router Information Protocol (RIP) traffic on the server. 


Syntax 


TRACK OFF 


Additional Information 


Topic See 

RIP Tracking Screen Section 1.171, “TRACK ON,” on page 266 
1.171 TRACK ON 

Purpose 


Use this command at the System Console prompt to view the RIP Tracking Screen and make it the 
active screen. This screen displays Router Information Protocol (RIP) traffic on the server. 


Syntax 


TRACK On 


Using TRACK ON 
+ TRACK On signals the router to display all server and network routing (RIP) packets that are 
received or sent. 
+ TRACK On displays information about servers, networks, and connection requests. 
This information is formatted according to whether the NetWare® server is 
+ Receiving incoming information (IN) 
+ Broadcasting outgoing information (OUT) 


+ Receiving a connection request 


Incoming Information 


Incoming information looks similar to the following: 
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IN [00D0C200:00001B026C09] 10:53:0lam 010123C5 11/22 5300DEEF 3/4 00001EF0 5/ 
365 





























FADE2401 12/98 00001EEE 2/3 C9008617 5/11 


The packet is incoming from network address 00D0C200 and from the server at node address 
0001B026C09. The packet was sent at 10:53 a.m. 


The columns of data that follow the line labeled IN are network numbers that the sending server 
knows about. For example, 010123C5 and 5300DEEF are the network numbers recognized by the 
server at address 00001B026C09. 


The numbers 11/22 and 3/4 indicate routing information about that network. For example, the 11/ 
and 3/ indicate the hop count, or number of hops (gateways or routers) from the sending server to 
this network. 


NOTE: The maximum number of hops a RIP packet travels is 16. 





The /22 and /4 indicate the number of ticks (1/18th of a second) that a packet took to reach this 
network from the sending server. 


Outgoing Information 


Outgoing information looks similar to the following: 


OUT [1986DAD0:8941A801] 11:00:0lam 








O0001EEE 2/3 5300DEEF 3/4 00001EF0 5/365 





























FADE2401 2/3 FEEDOOBB 4/5 ACCCDDD 5/11 














The packet is outgoing from network address 1986DADO and from the server at node address 
8941A801. The packet was sent at 11:00 a.m. 


The columns of data that follow the line labeled OUT are network numbers that the sending server 
knows about. The associated hop and tick count information is listed after each network. For an 
explanation of these, see “Incoming Information” on page 266. 


Connection Request 


When a client boots and loads a NetWare® Requester™ (such as DOS Requester or OS/2* 
Requester), a Get Nearest Server request is broadcast on the network the station is cabled to. 


Any connected server can receive the message and respond to the station with a Give Nearest Server 
response. 
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The station initially attaches to the first server that responds to the Get Nearest Server request. 


Additional Information 


Topic See 

Turning off the RIP Tracking Screen Section 1.170, “TRACK OFF,” on page 266 

Displaying advertised networks (SAP traffic) Section 1.42, “DISPLAY IPX NETWORKS,” on 
page 45 

Displaying advertised servers (SAP traffic) Section 1.43, “DISPLAY IPX SERVERS,” on 
page 46 

Resetting routers Section 1.143, “RESET ROUTER,” on page 171 


1.172 UNBIND 


Purpose 
Use this command at the System Console prompt to 


+ Remove a communication protocol from the LAN driver of a network board 


¢ Disable communication on a specific board 


Syntax 


UNBIND protocol [FROM] LAN driver | board name [[driver parameter/]] 


Parameter Use to 
protocol Specify the name of the protocol you want to unbind. 
LAN_driver | board_name Specify the name of the LAN driver or the network board from which you 


are unbinding the protocol. 


driver_parameter Specify one or more driver parameters if you have more than one 
network board of the same type in your server. See “Parameters” on 
page 268. 





NOTE: Enclose driver parameters in square brackets. 





Parameters 

Driver parameter Use to 

[DMA=number] Specify the DMA channel for the board. Use the same channel you did 
when you loaded the driver. 

[FRAME=number] Specify the frame type for the board. Use the same frame type you did 


when you loaded the driver. 
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Driver parameter 


[INT=number] 


[MEM=number] 


[PORT=number] 


[SLOT=number] 


[NODE=number] 


Use to 


Specify the interrupt for the board. Use the same interrupt you did when 
you loaded the driver. 


Specify the memory address for the board. Use the same memory 
address you did when you loaded the driver. 


Specify the I/O port for the board. Use the same l/O port you did when 
you loaded the driver. 


Specify the network board by the slot that it was installed in. 


Use this parameter with microchannel and ElSA computers. Use the 
same slot number you did when you loaded the driver. 


Specify the node number of the board. 


Using Driver Parameters 


+ You must tell the operating system which network board or LAN driver to unbind the 
communication protocol from. 


+ If you have multiple boards or LAN drivers, you must unbind each one separately. 


+ If your server has more than one instance of the LAN driver loaded, use one or more driver 
parameters to specify the particular board you are unbinding. 


+ To prevent a driver from binding automatically when the server boots, delete the following line 
from the autoexec.ncf file: 


BIND IPX TO LAN driver NET=number 


Examples 





+ To unbind IPX™ from an NE3200™ driver that has been loaded only once, type 


UNBIND IPX FROM NE3200 





¢ To unbind IPX from an NE3200 driver that has been loaded more than once, using driver 
parameters to specify the particular network board, type 





UNBIND IPX FROM NE3200 [SLOT=3, FRAME=ETHERNET_11] 


Additional Information 


Topic 




















See 


Viewing a list of communication protocols Section 1.124, “PROTOCOL,” on page 152 
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1.173 UNLOAD 


Purpose 
Use this command at the System Console prompt to 


+ Unload a module that was previously loaded with the LOAD command 
+ Unload outdated NLM™ programs so that updated modules can be loaded 


You can also use UNLOAD at workstations running Novell® Client™ software for client modules 
that have been previously linked with LOAD. 


Syntax 
UNLOAD NLM name 


UNLOAD ADDRESS SPACE=address space [NLM name] 




















UNLOAD KILL ADDRESS SPACE=address_space 


Parameter Use to 

NLM_name Specify the module you want to unload. 

ADDRESS SPACE= Specify the address space you want to unload. This command unloads 
address_space all modules from the address space, removes the space, and returns its 


resources to the system. 


ADDRESS SPACE= Specify the module you want to remove from the designated address 
address_space NLM_name space. This command unloads the specified module from the address 
space, but does not remove the address space. 


KILL ADDRESS SPACE= Remove the specified address space, but without unloading modules 
address_space from it first. Use this command only if you know the address space can't 
be unloaded any other way. 


IMPORTANT: Before you unload a module, be sure to read the next section, “Unloading Modules” 
on page 270. 





Unloading Modules 


The UNLOAD command unlinks a loadable module from the operating system that was previous 
linked to the operating system with the LOAD command. (See Section 1.82, “LOAD,” on page 87.) 
When you unload a module, all resources are returned to the system. 


To unload a module from an address space, you can specify its address space. 





NOTE: If an address is specified without a module, all modules in that address space will be 
unloaded. 
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Keep the following information in mind when unloading LAN drivers, name space modules, or disk 


drivers. 
+ LAN Drivers 


When you unload a LAN driver, the driver is unbound from all communication protocols and 
removed from all network boards it was linked to. 


After a LAN driver is unloaded, users with network boards that require the unloaded driver 
receive the following error message: 








Network error on Server <fileserver>: Error receiving from network. Abort, 
Retry? 


If this occurs, do the following: 


+ Retry once to see if an alternate route to the NetWare server is available on another 
network. 


+ If the retry fails, retry again after the LAN driver is reloaded and bound to the 
communication protocol. 


A user who receives the error message must reestablish a connection within 15 minutes. If the 
connection is broken for more than 15 minutes, the server watchdog terminates the station's 
connection. 


If the LAN driver will be unloaded for 15 minutes or longer, have users log out before 
unloading the LAN driver. 
+ Name Space Modules 


Before unloading name space modules, dismount all volumes that are using the module. These 
volumes cannot be remounted until the module is loaded again. 


To permanently delete a name space from a Traditional volume before you unload the name 
space module, use VREPAIR. 


+ Disk Drivers 


Before unloading a disk driver, dismount all volumes stored on the hard disks connected to the 
controller or host bus adapter. 


If you don't dismount the volumes, the system warns you that the driver is in use and lists the 
volumes using the driver. 


If you override the warning and unload the driver without dismounting the volumes, the server 
dismounts the volumes and notifies those who are using the volumes. 


Examples 
+ To unload MONITOR, enter 


UNLOAD MONITOR 


+ To unload the CLIB module from the address space for Group Wise®, enter 





UNLOAD ADDRESS SPACE=GRPWISE CLIB 











T 


+ To unload all modules from the GroupWise address space and shut down the address space, 
enter 
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UNLOAD ADDRESS SPACE=GRPWISE 








+ To shut down an address space 


that cannot be unloaded any other way, enter 








UNLOAD KILL ADDRESS SPAC 











E=ADDRESS_ SPACE1 














1.174 UPS AIO 


Purpose 


If your uninterruptible power supply (UPS) is connected to the server through a serial port, use 
UPS_AIO to provide the software link between your server and the UPS. 


Syntax 


[LOAD] [path]UPS AIO [parame 


Parameter 


path 


DOWNTIME=number 


MSGDELAY=number 


MSGINTERVAL=number 
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ter...] 


Use to 


Specify the path to UPS_AIO if you moved it from the default 
directory. 


Specify the amount of time to run on battery before system 
shutdown. If power is restored before this time elapses, no 
shutdown will occur. If a low battery condition occurs before this 
time elapses, an immediate shutdown will occur. 


Supported values: 30 seconds minimum, no practical maximum 
limit. 


Default: 300 seconds 


Specify the elapsed time before a broadcast message is first sent 
to users. 


Supported values: 0 seconds minimum, no practical maximum 
limit. 


Default: 5 seconds 


The broadcast message states the time remaining until shutdown. 
This message is generated automatically by UPS_AIO. 


Specify the time interval between broadcast messages sent to 
users. 


Supported values: 20 seconds minimum, no practical maximum 
limit 


Default: 30 seconds 


The broadcast message states the time remaining until shutdown. 
This message is generated automatically by UPS_AIO. 


Parameter 


DRIVERTYPE=number 


BOARD=number 


PORT=number 


SIGNAL_HIGH 


Use to 


Specify the AlO device driver type. 
Supported values: 1, 2, 3 
Default: 1 


The default value of 1 represents the AIOCOMX driver, which 
comes with NetWare®. Other drivers might be represented by 
other driver type numbers. Refer to the documentation that came 
with the driver. 


Specify the AlO board number. 
Supported values: Determined by the driver manufacturer 
Default: 0 


To determine the board number, read the driver information when 
the AIOCOMxX driver is loaded. This information includes both the 
board and port numbers. 


If you do not use the AIOCOMX driver, refer to the driver 
documentation to determine the board number. 


Specify the port number. 
Supported values: Determined by the driver manufacturer 
Default: 0 


To determine the port number, read the driver information when 
the AIOCOMxX driver is loaded. This information includes both the 
port and board numbers. 


If you do not use the AIOCOMX driver, refer to your driver 
documentation to determine the port number. 


Specify the signal_high parameter to set the normal RS232 
signaling state to high. 


Supported values: SIGNAL_HIGH or no value 


Use this parameter only if your UPS system uses high values, 
instead of low values, to determine if power is off or the battery is 
low. Most UPS systems use low values. Refer to your UPS 
hardware documentation to determine whether you need to use 
the parameter. 


Display a help screen that explains these parameters. When you 
use this parameter, the UPS_AIO module is not loaded. To load 
UPS_AIO, you must execute LOAD UPS_AIO again, without the ? 
parameter. 
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Using UPS_AIO 





NOTE: The serial cable between the UPS and the server must be designed for use with the UPS. 
Contact the manufacturer of your UPS for information on the correct cable to use for your system. 





+ You must load an AIO device driver before loading UPS_ AIO; the driver is not loaded 
automatically. The AIOCOMX driver is included with the NetWare operating system. If you 
want to use a different driver, consult the UPS hardware and driver documentation. 


+ The UPS_AIO module does not allow you to change parameter settings after loading the 
module. If you want to change the settings, reload the module with the new parameter values. 


+ Place the commands to load the device driver and UPS_AIO in your autoexec .ncf file to load 
them each time the server comes up. 


+ After you load UPS_AIO, a status screen displays messages about the current status and 
activities ofthe UPS. To toggle between this and other screens, press Alt Esc. These messages 
are also logged to sys:systemlsys$log.err 


1.175 VERIFY 


Purpose 


Use VERIFY to validate all blocks in an NSS pool. The Verify option fixes an NSS pool and its 
volumes by searching for inconsistent data blocks or other errors. This utility indicates if there are 
problems with the file system. If there are no problems with the pool, it is safe to activate the pool. 





NOTE: This utility protects against system failures only, not hardware failures. 





Syntax 


The PoolVerify command is a read-only assessment of the pool. At the server console, enter 


nss /poolverify=[pool_name] 


If you do not enter the NSS pool name parameter, you will be prompted to select it. 


During the verification process, the NSS pool and its volumes are placed in maintenance mode. This 
means the NSS pool and the volumes on it are unusable until this process is finished, and the pool is 
activated and mounted. 


If errors are found, they are reported to the screen, and the NSS pool is left in maintenance mode. 
Run REBUILD until no errors are found. 


Starting and Using VERIFY 


Use VERIFY at the command line. 
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NOTE: Always back up your data. If an NSS pool uses several hard disks and one of the hard disks 
becomes corrupted, you must create a new NSS pool, then restore its NSS volumes from backup. 





1 Load NSS. 
2 Verify your rebuilt NSS pool, by entering 


nss /poolverify=[pool_name] 


If you do not enter the NSS pool name parameter, you will be prompted to select it. 
Verifying a pool can take a up to a few hours, depending on the size of the pool. 
3 Check the output screen. 


This screen indicates the time elapsed, the time remaining, the total elapsed time, the number of 
objects processed, etc. 


Additional Information 


Topic See 


NSS volumes “Managing NSS Volumes” in the NW 6.5 SP8: NSS File System 
Administration Guide 


1.176 VERSION 


Purpose 


Use this command at the System Console prompt to view the file server version, license 
information, and copyright notice from the System Console prompt. This command also shows the 
version of the server Support Pack and Novell eDirectory that are running on the server. 


Syntax 


VERSION 


1.177 VIEW 


Purpose 





Use to view a file from the NetWare® server console. 





NOTE: VIEW does not let you create or modify files. To create or modify a file, use Section 1.52, 
“EDIT,” on page 56. 





Syntax 


[LOAD] VIEW [filename] 
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Parameter Use to 


filename Specify a file to view. 


Using VIEW 


If you do not specify a filename, VIEW prompts you for the name. 


1.178 VOLUME 


Purpose 


Use this command at the System Console prompt to list mounted volumes. 





Syntax 

VOLUME [name] 

Parameter Use to 

(no parameter) List general information about all mounted volumes. 
name Specify the volume you want to display information about. 


Using VOLUME 


When you execute VOLUME without the name parameter, a message similar to the following 


appears: 
Mounted Volumes Name Spaces Flags 
SYS DOS Cp Sa Mg 


The output lists each mounted volume, its name spaces, and the flags that are set for that volume. 
The three possible flags are: 


Cp—indicates that file compression is enabled on the volume 
Sa—indicates that block suballocation is enabled on the volume 
Mg—indicates that migration is enabled on the volume 


When you execute volume name, the screen displays more detailed information about the specific 
volume, such as the following: 
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Figure 1-11 Volume Information 


Volume SYS information: 


Block Usage: 4 FAT blocks, 34 Directories blocks, 0 EDS blocks 
Blocks: 1569 used of 4084 Directory Entries: 1314 used of 2176 
EDS: 0 used of 0 extants Extended Attributes: O 

Data Streams: 590, 668 (Cp), 9 (Cp Limbo), 242 (Cant Cp) 

Sub Alloc Blocks: 321 

NameSpaces: DOS Flags: Cp Sa 


1.179 VREPAIR 


Purpose 
For NetWare Traditional volumes, use this command at the System Console prompt to 


+ Correct volume problems 


+ Remove name space entries from Directory Entry Tables 





NOTE: You cannot use VREPAIR on a mounted volume. 


Also, VREPAIR is not used to repair NSS volumes. For NSS volumes, you must use the REBUILD 
utility. See Section 1.129, “REBUILD,” on page 158. 





Syntax 


[LOAD] [path] VREPAIR [volume_name] [log_filename] 





Parameter Use to 

path Specify the path to vrepair.nlm if you moved it from the default 
directory. 

volume_name Specify the name of a volume to repair. 

log_filename Specify a text filename to log errors into. 


Using VREPAIR 


¢ For an explanation of the VREPAIR main menu, see “Main Menu Selection” on page 279. 


¢ Ifa volume fails to mount when the server is brought up, VREPAIR loads automatically and 
tries to repair the failed volume. 


If you don't want VREPAIR to automatically repair a volume that won't mount, load 
MONITOR, select Server Parameters > File System, and set the Automatically Repair Bad 
Volume parameter to Off. (For more information, see Section 1.94, “MONITOR,” on 

page 102.) 


+ Use the version of VREPAIR that matches the operating system. 


¢ The majority of all problems fixed by VREPAIR are caused by hardware failures. If a volume 
frequently needs repair, consider replacing the hard disk or controller. 
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TIP: Copy vrepair.nlmand the VREPAIR name space support modules (v_namespace.nlm) 
to the boot partition of your server. Then, if volume sys: fails to mount, you can load and run 
VREPAIR from the DOS boot directory. 





Minor problems can occur on a volume if the primary File Allocation Table (FAT) or Directory 
Entry Table (DET) becomes corrupted. 


VREPAIR compares the primary tables with their mirrored counterparts. (The operating system 
keeps two copies of all tables. If hard disks are mirrored, then four copies are kept.) 


VREPAIR checks the sets of mirrored tables for errors. If it finds inconsistencies, it uses the most 
correct table entry as the corrected entry. VREPAIR then writes the corrected entry to both the 
primary and mirrored tables. 


VREPAIR may have to delete some corrupted files or tables. For more information, see “Viewing 
Deleted Files” on page 281. 


VEPAIR will log bad block information into a file if you specify a log filename when you load 
VREPAIR. You can also specify a log filename after you load VREPAIR, when VREPAIR displays 
an error. 


VREPAIR can repair a bad volume that you have dismounted while other NetWare server volumes 
are functioning. After you finish running VREPAIR, you can mount the repaired volume (in most 
cases). 


Use VREPAIR when 


+ A hardware failure either prevented a volume from mounting or caused a disk read error. 





NOTE: Although VREPAIR can't fix hardware problems, it can sometimes fix related volume 
damage. 





+ A power failure corrupted a volume. 


¢ The server displays memory errors and can't mount a volume after a name space (such as 
Macintosh*) is added to the volume. 


For this type of problem, either add more memory to the server or use VREPAIR to remove the 
newly added name space. 


¢ The volume has bad blocks. 
The following kinds of errors in FATs or Directory tables signal bad blocks: 
+ Read errors 
¢ Data mirror mismatch errors 
+ Multiple allocation errors 
¢ Fatal DIR errors 


+ Write errors 





TIP: This information is reported in the log file. 





The VREPAIR main screen displays the following menu: 
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Options: 


1 - Repair a volume 


2 - Set VRepair options 





3 - Exit 

Main Menu Selection Use to 

Repair a volume Begin or continue with volume repair. You can also use this option to stop 
a volume repair in process or change the method of displaying errors 
during the repair. 

Set VRepair options Set VREPAIR configuration options. 

Exit Exit VREPAIR. 


In the Set VRepair Options menu, there are two settings for each option, a default option and an 
alternate option. When VREPAIR autoloads and tries to repair a volume that will not mount, the 
default settings are used. 


You can configure the VREPAIR alternate options by selecting the associated option number to 
toggle between the alternate and default options. 


For example, Option 2 settings are Write All Directory and FAT Entries Out to Disk and Write Only 
Changed Directory and FAT Entries Out to Disk. 


The default for Option 2 is Write Only Changed Directory and FAT Entries Out to Disk. If you select 
Option 2, your current VREPAIR configuration reflects the change from the default to the new 
setting: Write All Directory and FAT Entries Out to Disk. 


The VREPAIR configuration options are described in the following table. 
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Table 1-22 VREPAIR Configuration Options 


Default Option Alternate Option 


1. Quit ifa VREPAIR Remove Name Space 
Name Space Support Support From The 
NLM™ Is Not Loaded Volume 


2. Write Only Changed Write All Directory And 
Directory And FAT FAT Entries Out To Disk 
Entries Out To Disk 


3. Write Changes Keep Changes In 
Immediately To Disk Memory For Later 
Update 


4. Retain Deleted Files Purge All Deleted Files 
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Explanation 


These options control whether name space support 
for non-DOS files is retained in the volume tables. 


If you add a name space to a volume and the 
system doesn't have enough memory, select 
Remove Name Space Support From the Volume. 
Then select a name space to delete. 


If you remove a name space, the accompanying 
extended file information is destroyed. 


For example, if you remove Macintosh name 
support, the Macintosh long names, the finder 
icons, and the resource forks are destroyed. 


(The DOS name and its data file are kept and are 
accessible from DOS workstations.) 


Important: To repair a volume with non-DOS name 
space entries, VREPAIR must find the 
corresponding name space support modules. (For 
example, to repair a volume with the Macintosh 
name space, you need to load v_mac.nlm; to 
repair a volume with the OS/2* or Windows* name 
space, load v_1ong.nlm.) 


For more information, see “Repairing a Traditional 
Volume” in the NW6.5 SP8: Traditional File System 
Administration Guide. 


These options control the changes that are made to 
the FATs and Directory tables. 


If you repair a mirrored or duplexed volume, select 
the alternate option to force an update of all tables 
on both hard disks. 


NetWare defaults to writing changes immediately to 
disk. In most cases, this default option speeds the 
repair. 


Disks requiring very few changes will repair faster if 
the alternate option is used. 


These options control whether deleted files are 
purged or retained. 


If a file is deleted, but not purged, it can be 
salvaged. 


Purge deleted files if you are concerned about the 
amount of disk space being used to retain deleted 
files or if you don't want users to salvage files (for 
example, for security reasons). 


Default Option Alternate Option Explanation 


5. Return to Main Menu After you select the VREPAIR configuration options, 
press menu item 5 to return to the VREPAIR main 
menu. 


Displaying Errors during Repair 


There are run-time options you can modify during the VREPAIR process to change the way errors 
are displayed. To view the options, select the main menu option, Repair a Volume. 

+ Select Option 1 if you do not want VREPAIR to pause after each error. 

+ Select Option 2 if you want VREPAIR to log errors in a text file. 

+ Select Option 3 to stop the repair of the volume. 


+ Select Option 4 to continue with a volume repair after you have temporarily suspended the 
repair. 


Viewing Deleted Files 


The repair operation can create new files containing data that VREPAIR deleted. You can access 
these files if you select the default configuration option, Retain Deleted Files. The files are 
numbered and named vrnnnnnn. fil where n is any number. 


These numbered files are created in any of the following circumstances: 


+ VREPAIR found a filename that has an invalid DOS name. The filename might contain invalid 
characters or might be too long. 
+ VREPAIR found that the filename is not unique. (Another file exists with the same name.) 


+ VREPAIR found a FAT chain without a file showing ownership of it. 


NOTE: A file is divided into a series of data blocks that are linked together in a FAT chain. 





¢ No files in the Directory Entry Table (DET) claimed ownership of the data, so a new filename 
was generated to point to this data. 


VREPAIR might create as many as several thousand of these files. These numbered files are created 
in the directory where they were found during the volume repair operation. 


You might be able to recover some or all of the files deleted by VREPAIR. Contact Technical 
Support for more information. 
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Additional Information 


Topic See 


Repairing a NetWare traditional volume or NSS (For NetWare Traditional volumes) “Repairing a 
pool Traditional Volume” in the NW6.5 SP8: Traditional 


File System Administration Guide 


(For NSS pools on NetWare) “Verifying and 
Rebuilding an NSS Pool and Its Volumes” in the 
NW 6.5 SP8: NSS File System Administration 
Guide 


1.180 WAN Traffic Manager 


WAN Traffic Manager allows you to manage how and when traffic is sent across WAN links, thus 
reducing network costs. It consists of three elements: 


+ Wtm.nim, which resides on each server in the eDirectory™ tree. Before eDirectory sends 
server-to-server traffic, wtm.nlm reads a WAN traffic policy and determines whether that 
traffic will be sent. 


+ WAN traffic policies, which are rules that control the generation of eDirectory traffic. WAN 
Traffic Policies are text stored as an eDirectory property value on the NetWare® Server object, 
the LAN Area object, or both. 


+ WANMAN ConsoleOne™ snap-in which is the interface to WAN Traffic Manager. It allows 
you to create or modify policies, create LAN Area objects, and apply policies to LAN Areas or 
to servers. 


When WAN Traffic Manager is installed, the schema will include a LAN Area object and three 
new detail pages on the Server object: 


+ LAN Area Membership 
+ WAN Policies 
+ Cost 


A comprehensive Help system is built into the utility. For addition information and procedures, refer 
to the Help system. 


1.181 XLOG 


Purpose 


Use the XLOG utility to help diagnose ISDN-related connection problems with Eicon* Technology 
ISDN adapters. 
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1.182 XNTPD 


Purpose 


XNTPD is the implementation of Network Time Protocol Version 3 (NTPv3) on NetWare 6.5 based 
on RFC 1305. It is the new time synchronization service that is used to synchronize time with 
servers that are NTPv3 compliant. 


Syntax 


XNTPD [-aAbdm] 


p pidfilel 
variable] 


[-c conffile] 
[-r broadcastdelay] 
[-T slp/noncp] [-S] 


[-£ driftfile] 
[-s statsdir] 


[-k keyfile] [-1 logfile] [- 
[-t key] [-v variable] [-V 


Table 1-23 XNTPD Parameters 


Parameter 


-c conffile 


-d 


-f driftfile 
-k keyfield 
-| logfile 


-m 


-p pidfile 


-r broadcastdelay 


-s statsdir 
-t key 

-v variable 
-V variable 


-T sip 


Use to 

Enable authentication mode. By default, authentication is enabled. 
Disable authentication mode. 

Synchronize using NTP broadcast messages. 

Specify the name and path of the configuration file. 


Specify the debugging mode. This flag might occur multiple times, with each 
occurrence indicating greater detail of display. 


Specify the name and path of the drift file. 
Specify the name and path of the file containing the NTP authentication keys. 
Specify the name and path of the log file. 


Synchronize using NTP multicast messages on the IP multicast group address 
224.0.1.1. Requires multicast kernel. 


Specify the name and path to record the daemon's process ID. 


Specify the default propagation delay from the broadcast/multicast server to 
your server. This is used only if the delay cannot be computed automatically by 
the protocol. 


Specify the directory path for files created by the statistics facility. 
Add a key number to the trusted key list. 

Add a system variable. 

Add a system variable listed by default. 

Provide Timesync migration or backward compatibility options. 


Enables NTP to automatically discover SLP advertising Timesync Single server 
on the network and add that server’s IP address to the ntp . cfg configuration 
file as a time provider. 
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Parameter Use to 


-T noncp Stop the NCP engine on XNTPD, which serves all NCP time requests from 
NetWare 4, Novell clients, and DSREPAIR. 


-S Step synchronization. XNTPD sets the clock to the time of the best available 
server, then sets the clock status to “nearly in sync.” Basically, it helps speed 
synchronization. 


Using XNTPD 
+ XNTPD is an operating system service that sets and maintains the system time-of-day in sync 
with Internet standard time servers. 


+ XNTPD reads the ntp.cfg configuration file at startup in order to determine the 
synchronization sources and operating modes. 


+ XNTPD can operate in any of several modes, including client-server and broadcast/multicast 
mode, as described in RFC-1305. 


¢ A broadcast/multicast client can discover remote servers, compute client-server propagation, 
delay correction factors, and configure itself automatically. This makes it possible to deploy a 
fleet of workstations without specifying configuration details specific to the local environment. 


Examples 
¢ To start XNTPD normally, enter 
XNTPD 
¢ To start XNTPD with debug level 4, enter 
XNTPD -D 4 
+ T 


XNTPD -S 


start XNTPD with fast synchronization enabled, enter 


© 








+ To start XNTPD with auto discovery of Timesync time sources, enter 











XNTPD -T slp 
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LAN Driver Statistics 


This appendix contains information on both common and custom LAN driver statistics. 


A.1 Monitoring Network Traffic 


By comparing information about LAN drivers installed on your server, you can tell which cabling 
system is handling the most traffic. 


If errors occur frequently on a high-traffic system, you may want to switch some of the stations on 
the busy system to a new or less busy cabling system. 


To view LAN driver statistics: 


1 At the server console prompt, enter 
[LOAD] MONITOR 
2 Select Available Options > LAN/WAN Drivers. 
3 Select a LAN driver from the Available LAN Driver menu. 


The statistics for the selected LAN driver are displayed. Press Tab > PageUp or PageDown to scroll 
through the information in the window. 


For more information, see Section 1.82, “LOAD,” on page 87. 


A.1.1 Common LAN Driver Statistics 


The generic statistics common to most of the drivers are maintained by two modules in the 
NetWare® operating system that are autoloaded by LAN drivers. The modules are: 
+ The Media Support Module™ (msm. n1m) 
+ The Topology Specific Module™ (tsm.n1m) 
There are three TSM™ modules. The one that is autoloaded will depend on your server's LAN 
driver. The three are ETHERTSM (Ethernet), TOKENTSM (token-ring), and FDDITSM. 


These common LAN driver statistics can be viewed with MONITOR. Select Available Options > 
LAN/WAN Drivers, and then select a driver. The system displays a window containing both the 
generic and custom statistics for the selected driver. 


Brief descriptions of the statistics maintained by the MSM module and each of the TSM modules are 
found in the following tables: 


+ Table A-1 on page 286 
+ Table A-2 on page 289 
+ Table A-3 on page 290 
+ Table A-4 on page 291 
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A.1.2 Custom LAN Driver Statistics 


Custom statistics describe LAN activity for specific LAN device drivers. 


The custom LAN driver statistics can be viewed with MONITOR. Select Available Options > LAN/ 
WAN Drivers, and then select a driver, then press Tab. The system displays a window containing 
both the generic and custom statistics for the selected driver. 


Brief descriptions of statistics for selected drivers are found in the following tables: 


+ Table A-5 on page 291 
+ Table A-6 on page 295 
+ Table A-7 on page 297 





NOTE: Custom statistics vary, depending on the LAN driver installed. For statistical information 
about third-party drivers not listed in the custom statistics section, check the documentation that 
comes with the driver. 





Table A-1 LAN Driver Statistics 


Statistic Description 


Driver Name The driver name and parameters that correspond to the hardware 
settings on the network board. 


Version The current version of the driver. 


Logical Board Number The number which uniquely identifies each time a driver is 
registered with the system. 


Board Instance Number The number assigned to each physical adapter for which the 
driver has been loaded.. 


Node Address The station or node address of the network board in the NetWare 
server. 

Protocols The communication protocols bound to the driver with BIND. 

Network The network number assigned to the cabling system the LAN 


driver is operating on. Appears only if the IPX™ protocol has 
been bound to the board. 


Total Packets Transmitted The number of packets sent from the NetWare server through 
this LAN driver since the driver was loaded. 


(By comparing this figure with the figures for other LAN drivers, 
you can see which driver is handling the most traffic.) 


This value is maintained by the TSM module. 


Total Packets Received The number of packets received by the NetWare server sincethe 
driver was loaded. This includes file service requests, packets 
routed to another network, and packets sent to other IPX sockets 
in the NetWare server. 


This value is maintained by the TSM module. 
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Statistic 


Transmit failed, packet too big 


Transmit failed, packet too small 


Receive discarded, no available 
buffers 


Receive failed, packet too big 


Receive failed, packet too small 


Receive failed, adapter overflow 


Transmit failed, Miscellaneous Error 


Receive failed, Miscellaneous Error 


Transmit failed, retried 


Description 


A counter that is incremented when the NetWare server tries to 
transmit a packet that is too large for the hardware to handle. 


This value is maintained by the TSM module. 


A counter that is incremented when the NetWare server tries to 
transmit a packet that is too small. 


This value is maintained by the TSM module. 


A counter that is incremented when a device sends a packet to 
your NetWare server, but no packet receive buffer is available. 


The server allocates more packet receive buffers after each 
incident until it reaches its maximum limit (configured with a SET 
parameter). 


If you are using an EISA or microchannel bus-master board (such 
as the NE3200™ board), you will probably need to increase both 
the minimum and maximum number of packet receive buffers. 


See Minimum Packet Receive Buffers and Maximum Packet 
Receive Buffers in SET “Communications Parameters” on 
page 193. 


No ECB Available Count messages can also indicate that the 
driver is not configured correctly or that the TSM module and the 
Hardware Specific Module™ (HSM™) are incompatible. 


This value is maintained by the TSM module. 


A counter that is incremented when the NetWare server receives 
a packet that is too big for the provided receive buffers. 


This value is maintained by the TSM module. 


A counter that is incremented when the NetWare server receives 
a packet that is too small. 


Currently only the RX-Net™ TSM module maintains this counter. 


A counter that is incremented each time the adapter's private 
receive buffer pool was exhausted. This causes subsequent 
incoming packets to be discarded. This value is maintained by 
the HSM module. 


A counter that is incremented when errors with send packets 
occur. 


This value is maintained by the HSM module. 


A counter that is incremented when errors with receive packets 
occur. This value is maintained by the HSM module. 


A counter that is incremented when the NetWare server tries to 
send a packet but fails because of a hardware error. 


The server tries to send the packet until either it succeeds or the 
retry setting is reached. 


This value is maintained by the HSM module. 


LAN Driver Statistics 


287 


Statistic 


Receive failed, checksum error 


Receive failed, packet length 


Bytes transmitted modulo 4 GB 


Bytes transmitted rollover <times 4 
GB> 


Bytes received modulo 4 GB 


Bytes received rollover <times 4 GB> 


Transmitted to a group address 


Received from a group address 


Adapter resets 


Adapter state change time stamp 


Packets queued for transmission 
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Description 


A counter that is incremented when the checksum byte at the end 
of the packet does not match the sum of the bytes contained in 
the packet. 


This indicates a data error. 
This value is maintained by the HSM module. 


A counter that is incremented when the packet length received by 
the hardware and the length specified by the packet do not 
match. 


Currently only the Ethernet TSM module maintains this counter. 


The number of bytes, including low-level headers, successfully 
transmitted. 


This value is maintained by the TSM module. 


Upper 32 bits of the Total Send OK Byte Count Low. The Total 
Send OK Byte Count High statistic is incremented to 1 when the 
Total Send OK Byte Count Low counter reaches 4 GB. 


This value is maintained by the TSM module. 


The number of bytes, including low-level headers, successfully 
received. This value is maintained by the TSM module. 


Upper 32 bits of the Total Receive OK Byte Count Low. 


The Total Receive OK Byte Count High statistic is incremented to 
1 when the Total Receive OK Byte Count Low value reaches 4 
GB. 


This field is maintained by the TSM module. 


The number of packets transmitted with a group or multicast 
destination address. This field is maintained by the TSM module. 


The number of packets received with a group or multicast 
destination address. This field is maintained by the TSM module. 


The number of times the adapter was reset because of internal 
failures or other calls to the Driver Reset routine. 


This field is maintained by the HSM module. 


The time stamp indicating when the adapter last changed 
operational state (such as load, shutdown, or reset). 


This value is maintained by the MSM module. 


The number of transmit packets (transmit ECBs) that are queued 
for the adapter. 


This is an indication of throughput overload on transmits. 


This field is maintained by the TSM module. 


Table A-2 Generic Statistics for Ethernet Drivers That Use Ethertsm.nlm 


Statistic 


Transmit succeeded, single collision 


Transmit succeeded, multiple 


collisions 


Transmit succeeded, deferred 


Transmit failed, late collision 


Transmit failed, excessive collisions 


Transmit failed, carrier sense missing 


Transmit failed, excessive deferral 


Receive failed, bad frame alignment 


Description 


The number of frames involved in a single collision that are 
subsequently transmitted successfully. 


When the Ethernet controller detects a collision, it backs off and 
then retries the transmission. 


The number of frames involved in more than one collision that are 
transmitted successfully. 


This happens if the Ethernet controller had to back off more than 
once due to collisions. 


The number of frames whose transmission was delayed because 
of a busy medium. 


This happens if another station is transmitting on the wire when 
the adapter receives the command to transmit a packet. 


The number of transmits that had a collision after 512 bits of the 
packet were transmitted. 


This can be caused by faulty adapters, faulty network equipment, 
cables that are too long, or faulty terminators. 


The number of transmits that were aborted because of too many 
collisions. 


This usually indicates that a board in the network is bad or 
jabbering. (Jabbering means the board has been on the channel 
longer than the time needed to transmit the maximum size 
packet.) 


This condition could also occur in very heavy traffic conditions. 


The number of transmits aborted because of loss of carrier sense 
while transmitting without any collisions. 


This is usually caused by a faulty adapter in the network, faulty 
cabling, an unterminated cable, or a faulty repeater. 


The number of transmits aborted because of excessive deferrals. 


This is usually caused by a faulty adapter or repeater in the 
system that is jabbering on the wire. 


It can also occur under very heavy traffic conditions. 
The number of received frames that were misaligned. 


This occurs when the number of octets in the frame is not correct 
or the frame does not pass the FCS check. 


These bad packets are usually caused by a faulty adapter or 
repeater in the system. They can also be caused by a collision. 
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Table A-3 Generic Statistics for Token Ring Drivers That Use Tokentsm.nlm 


Statistics 


AC Errors 


Transmit failed, abort delimiter sent 


Burst errors 


Frame copied errors 


Frequency errors 


Recoverable internal error 


Last ring status 


Line errors 


Transmit failed, lost frame 


Error tokens transmitted 


Upstream node address 
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Description 


This counter is incremented when a ring station receives a 
Standby Monitor Present MAC frame with the A/C bits in the 
Frame Status field equal to zero without first receiving an Active 
Monitor Present MAC frame. 


This counter is incremented when a ring station transmits an 
abort delimiter. 


An abort delimiter is transmitted when a ring station receives a 
frame in which the token bit of the access control field is set to 
show Token and not Frame. 


A ring station can also transmit an abort delimiter if an internal 
hardware error has occurred. 


This counter is incremented when a ring station detects the 
absence of five half-bit times (a burst-five error). 


Other stations will detect a burst-four error followed by idles. 


This counter is incremented when a ring station recognizes 
(receives or repeats) a frame addressed to its specific address 
and detects that the FC field A bits are set to 1, indicating a 
possible line hit or a duplicate address. 


This counter is incremented when the frequency of the incoming 
signal differs from the expected frequency by more than that 
specified in Section 7 of IEEE Standard 802.5-1989. 


This counts the times a ring station has a recoverable internal 
error, which means a ring station is probably marginal. 


This code changes each time the ring status changes. Status 
codes are reported by the physical hardware. 


See the IBM* Token-Ring Network Architecture Reference for the 
status code, function, and meaning. 


This counter is incremented when a frame or token is repeated by 
the ring station. 


A frame is repeated when a Frame check Sequence error occurs 
or a code violation exists between the starting and ending 
delimiters of the frame. 


This counter is incremented when a ring station transmits a frame 
that does not return to the station. 


The active monitor sends a new token. 


This counter is incremented when a station acting as the active 
monitor recognizes an error condition that needs a token 
transmitted. 


This occurs when the TVX time expires. 


The twelve digits of the upstream node address of the next node 
up stream on the ring. 


Statistics 


Last ring ID 


Last beacon type 


Description 


This contains the value of the local ring ID. 


This contains the value of the last beacon type. 


Table A-4 Generic Statistics for FDDI Drivers That Use Fdditsm.nlm 


Statistic 


Configuration State 


Upstream Node Address 
Downstream Node Address 


Receive failed, frame error 


Receive failed, lost frame 


Ring Management State 


Consecutive LCT failures 


LEM, link rejected 


LEM, total errors 


Connection state 


Description 


The attachment configuration for the station or concentrator: 


O=isolated; 1=local_a; 2=local_b; 3=local_ab; 4=local_s; 
5=wrap_a; 6=wrap_b; 7=wrap_ab; 8=wrap_s; 9=c_wrap_a; 
10=c_wrap_b; 11=c_wrap_s; 12=thru 





The upstream neighbor's MAC address (0 if unknown). 
The downstream neighbor's MAC address (0 if unknown). 


The number of frames that were detected in error by this MAC 
that had not been detected in error by another MAC. 


The number of instances that this MAC detected a format error 
during frame reception such that the frame was stripped. 


Indicates the current state of the Ring Management state 
machine: 


O=Isolated; 1=Non_Op; 2=Ring_Op; 3=Detect; 4=Non_Op_Dup; 
5=Ring_Op_Dup; 6=Directed; 7=Trace 


The count of the consecutive times the link confidence test (LCT) 
has failed during connection management. 


The link error monitor (LEM) count of the times that a link was 
rejected 


The aggregate link error monitor (LEM) error count. 


The state of this port's Physical Connection Management (PCM) 
state machine: 


0=Off; 1=Break; 2=Trace; 3=Connect; 4=Next; 5=Signal; 6=Join; 
7=Verify; 8=Active; 9=Maint 


Table A-5 Custom Statistics for NE2000, NE2, NE2_32, CNE2_32, and Other Ethernet Drivers 


Statistic 


UnderrunErrorCount 


TransmitTimeoutCount 


Description 


This counter is incremented when the RAM buffer on the network 
board is full; the board cannot accept any more packets until the 
RAM buffer is cleared. 


This counter is incremented when a network board interrupts the 
file server with the message that the send bit is lost. 


This is a hardware problem caused by faulty cabling, a bad 
network board, or a missing terminator. 
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Statistic 


RxPagingErrorCount 


ReceiveFlFOOverrunErrorCount 


ReceiverMissedPacketCount 


GotNothingCount 


UnsupportedFramePacketCount 


UnsupportedMulticastCount 


BackToBackSendCount 


EnqueuedSendCount 


HeartBeatError 


MemoryTimeout 
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Description 


This is a count of the errors that occur when internal buffers on 
the board are corrupted. 


This counter is incremented when an incoming packet causes an 
overflow because FIFO was not serviced. 


This counter is incremented when a packet is sent to a network 
board that cannot accept the packet because all its receive 
buffers are full. 


This counter is incremented when the file server receives an 
interrupt from a network board that is not transmitting or receiving 
anything. 


This is not serious. 


This counter is incremented when a packet is received by the 
LAN driver with a frame type that hasn't been loaded for the given 
board. 


This counter is incremented for each multicast packet received by 
the board that is not registered with the driver. 


This counter is incremented each time the driver can buffer a 
send packet onto the network board while the board is sending a 
previous buffer. 


Use this counter to track congestion on the network board. 
See also EnqueuedSendsCount. 


This counter is incremented when the driver is unable to transmit 
a packet and must put the packet in a queue until the transmitter 
is available. 


Use the counter to track congestion on the network board. 
See also BackToBackSendCount. 


(NE2100™, NE1500T™, or CNEAMD™) This counter is 
incremented when there is a signal quality error. 


This function is also known as the heartbeat or Signal Quality 
Error (SQE) test. 


This counter indicates a hardware problem. 


(NE2100, NE1500T, or CNEAMD) This counter is incremented 
when there is contention on the bus. 


If this counter is incremented, there may be multiple boards in the 
server or another bus-mastering device in the server, such as a 
LAN or disk channel device. 


Statistic 


TxBabblingError 


TxUnderflowError 


TXBufferError 


RxECBsOver16MegCount 
TxECBsOver16MegCount 


PacketUsed2ECBs 


Description 


(NE2100, NE1500T, or CNEAMD)This counter is incremented 
when there is excessive length in the transmit buffer. 


It will increment after 1,519 data bytes have been transmitted 
from the buffer. 


It indicates that the transmitter has been on the channel longer 
than the time required to send the maximum length packet. 


If this counter is incremented, it indicates a hardware problem 
with the network board in the server. 


(NE2100, NE1500T, or CNEAMD) This counter is incremented 
when something else on the bus takes control of the bus while 
the LAN driver is putting the data on the wire. 


If this occurs, the packet must be retransmitted. 


(NE2100, NE1500T, or CNEAMD) This counter is incremented 
when there is a problem with the transmit buffer. 


This counter is usually incremented when TxUnderflowError is 
incremented; it indicates a hardware problem in the server. 


(NE2100, NE1500T, or CNEAMD) One of these counters is 
incremented when either a transmit or receive occurs and the 
driver has double buffered the ECB in the reserved buffers below 
16 MB in memory. 


These boards require double buffering because they have a 
physical limitation that prevents them from accessing memory 
above 16 MB. 


Therefore, if the operating system issues an Event Control Block 
(ECB) with a memory address above 16 MB, the board uses 
some of the reserved buffers below 16 MB to queue the request. 


These are not errors. This value tracks how many ECBs are 
redirected to the buffers below 16 MB. 


In many cases, this counter can be as high as the total packets 
sent and received. This double buffering decreases performance. 


If you have more than 16 MB of RAM and a board that is bus- 
mastering or using DMA that is not a 32-bit adapter, performance 
might be degraded. 


(NE2100, NE1500T, or CNEAMD) This counter is incremented if 
the Server Maximum Physical Receive Packet Size is set to 1514 
bytes (default for NetWare 3.11 servers), and you need to receive 
a near-full-size packet. For NetWare 3.12 and 4.x, the default 
Maximum Physical Receive Packet Size is 4202. 


In this instance, two ECBs are used instead of one, since the 
CRC on the end of the packet requires an extra four bytes. 


Using two ECBs instead of one may decrease performance 
slightly. 


LAN Driver Statistics 


293 


Statistic 


TransmitRetryCount 


TxClearToSendsErrors 


TxDMAUnderrunErrors 


RxDMAOverrunErrors 


RxPacketSlideErrors 


RxDummyRCBUsedErrors 
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Description 


(NE3200™) This counter is incremented when the driver is 
unable to transmit a packet after a specified number of times. 


This may indicate a hardware problem. 
(NE3200) This counter tracks an 82586 error. 


There are some conditions when the Clear to Send signal from 
the 82586 chip is incorrect. 


This counter indicates the number of times the corrective code on 
the adapter was executed to work around this condition in the 
82586. 


(NE3200) This counter tracks an 82586 error. 


Contention among the BMIC, 80186, and 82586 can occur on the 
adapter, causing the 82586 to assume it did not receive all of the 
packet for transmission. The transmit operation must then be 
retried. 


This counter indicates the number of times the corrective code on 
the adapter was executed to work around this condition. 


(NE3200) This counter tracks an 82586 error. 


If two packets are received back-to-back at close to 9.6 
microseconds (the minimum Ethernet interframe spacing), then 
the chip may report an overrun. 


If so, the frames are lost by the chip and the source must 
retransmit. 


This counter indicates the number of times this error has 
occurred. 


(NE3200) This counter tracks the number of instances of an 
82586 anomaly. 


In some conditions, the 82586 might be off by two bytes in the 
receive packet descriptors. In this case, the sending station must 
retransmit the packet. 


This counter indicates the number of times this condition has 
occurred. 


(NE3200) This counter tracks an 82586 error. 


In some cases, the 82586 may attempt to receive data into a 
nonexistent receive buffer at the end of its receive buffer list. 


To catch this condition and avoid internal data corruption, a 
dummy receive buffer is added to the end of the list. 


This variable counts the number of times the 82586 attempted to 
write into the dummy buffer. 


Statistic 


InternalAdapterReset 


MondoFragmentLengthErrors 


PollingTimeout 


ResetBecauseHardwareDiedErrors 


NumberOflinterruptsFired 


Description 


(NE3200) This counts the number of resets (by the 80186) that 
occurred on the adapter due to failures on the adapter. 


This counter is incremented when the software corrects itself for 
minor problems or if the adapter is in an unknown state. 


It is common for this counter to be incremented. 


Under normal conditions, more of these errors should occur 
during idle time than when the driver is busy. 


This counter would only indicate a hardware problem if it 
registered thousands of these errors when the network is busy. 


(NE3200) This counter tracks the number of instances in which 
an NLM™ on the server has passed the NE3200 driver an ECB 
whose logical memory address could not be translated to a 
physical memory address. 


You should check other NLM programs on the system and 
upgrade them. 


If you are still experiencing problems, identify which NLM is 
causing the problem and contact the third-party manufacturer of 
the NLM. 


(NE3200) This counter tracks the number of times the adapter's 
request was put on the queue but was not serviced within 800 
nanoseconds (default). 


After this occurs, the adapter fires an interrupt. 


(NE3200) If the adapter is in an unknown state or stops 
transmitting on the host side, the driver increments this counter 
and resets or restarts the adapter. 


(NE3200) This counter is incremented each time the adapter had 
to fire an interrupt to service a request because the polled 
request wasn't serviced. 


Table A-6 Custom Statistics for Token Ring Drivers 


Statistic 


Bad Correlator Count 


Description 


(CNTR2000™, NTR2000™) This counter is incremented when a 
network board responds with a request for data from the file 
server that the file server does not have. 


The ECB or some other code may be corrupted. Eventually, this 
error will abend the server. 


If this counter is non-zero, you should try to find the software that 
is corrupting the data. 
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Statistic 


Unknown ARB requests 


MicroChannel Error Count 


ECBs Over 16 MB 


DMA Bus Errors Count 


DMA Parity Errors Count 


Command Reject Count 


Tx Timeout Count 


Transmit Late Count 
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Description 


(CNTR2000, NTR2000) This counts bad Adapter Request Blocks 
(ARBs). 


Normally the network board (adapter) uses one of four known 
commands to communicate with the driver. 


If a network board sends a command that is not one of the four, 
the driver does not recognize the request. 


This error is not a catastrophic error. 


Sometimes old adapters send bad ARB requests because of 
software problems on the board. 


NetWare responds to the network board so that the board will not 
hang. 


(TOKENDMA) This counter tracks the number of times the 
adapter had a problem transmitting on the bus. 


The adapter interrupt occurred from the firmware on the board. 


(TOKENDMA) This counter tracks the number of packets 
received that had to use an ECB over 16 MB. 


This number should increment only when more than 16 MB of 
RAM is used in the server. 


(TOKENDMA) This counter is incremented when a DMA transfer 
completes with a bus error. 


If this counter is incremented, it could indicate a hardware 
problem. 


(TOKENDMA) This counter is incremented when a DMA transfer 
completes with a parity error. 


If this is incremented, it could indicate a hardware problem. 


(TOKENDMA) This counter is incremented when the driver sends 
a command to the board and the command is either invalid or the 
board is still busy processing the previous command. 


This number should be zero or a low number. 


(TOKENDMA) This counter is incremented and the adapter is 
reset if two seconds elapse before the driver learns from the 
firmware that the transmit was or wasn't successful. 


This counter shows the driver is successfully recovering from the 
lost hardware transmit. 


It isn't a problem if this number is incremented. 


(TOKENDMA) This counter is incremented when the firmware 
reports that the board transmitted more than it actually did. 


After this event occurs, the data that wasn't transmitted will be 
sent in the next packet. 


This problem is more likely to occur on busier networks. 


Statistic 


Transmit Defragment Count 


Description 


(TOKENDMA) This counter tracks how many ECBs are 
redirected to the buffer below 16 MB. 


The IBM Token-Ring DMA LAN boards are not able to access 
memory above 16 MB. Therefore, if the operating system issues 
an Event Control Block (ECB) with a memory address above 16 
MB, the board uses some of the reserved buffers below 16 MB to 
double buffer the ECB. 


These are not errors. In many cases, this counter can be as high 
as the total packets sent and received. However, this double 
buffering decreases performance. 


If the system has more than 16 MB of RAM and a board that is 
bus-mastering or using DMA that is not a 32-bit adapter, 
performance may decrease. 


Table A-7 Custom Statistics for IBM Baseband PCN2L Drivers 


Statistic 


HotCarrierlnterruptCount 


No82588InterruptCount 


WeirdInterruptCount 


BadTransmitComplete-InterruptCount 


HardTransmitErrorCount 


GotNothingCount 


ReceiveUnderrunErrorCount 


ReceivedShortPacketCount 


Description 


(PCN2L) This counter is incremented when the board detects a 
carrier longer than expected without a transmit. 


This indicates that some board on the network has failed or is 
beginning to fail. 


(PCN2L) This counter is incremented each time the server 
receives an interrupt from the board, but not from the 82588 
chip. 


This should happen very seldom, if ever. 


(PCN2L) This counter is incremented when the server has 
received an interrupt from the board, but the board claims not to 
have sent one. 


This should happen very seldom, if ever. 


(PCN2L) This counter is incremented for each complete 
transmission with no transmit active. 


(PCN2L) This counter is incremented when a transmit fails and 
the driver retries the transmit. 


(PCN2L) This counter is incremented when the driver receives 
an interrupt from the board indicating that it has completed a 
receive but there is no data in the board's receive buffer. 


This is not serious. 


(PCN2L) This counter is incremented when the driver finds less 
data in the board's buffer than the board reported. 


(PCN2L) This counter is incremented when a packet of 
fewerthan 17 bytes is received. 
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Statistic Description 


BadReceiveConditionCodeCount (PCN2L) This counter is incremented when the buffer is flushed 
because the board hasn't received the incoming packets 


properly. 
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Documentation Updates 


The Utilities Reference has been updated on the following dates: 


¢ Section B.1, “November 9, 2009,” on page 299 

+ Section B.2, “December 2008,” on page 299 

¢ Section B.3, “October 25, 2006 (NetWare 6.5 SP6),” on page 299 

¢ Section B.4, “December 23, 2005 (NetWare 6.5 SP5),” on page 299 
¢ Section B.5, “August 19, 2005 (NetWare 6.5 SP4),” on page 300 


B.1 November 9, 2009 


This guide has been modified for publication on the NetWare 6.5 SP8 Documentation Web site. 


B.2 December 2008 


This guide was updated to documentation standards for NetWare 6.5 SP7. 


B.3 October 25, 2006 (NetWare 6.5 SP6) 


Changes were made to the following sections: 


Location Change 
Multiple utilities Information was added to the following utilities: 


+ Health (page 65) 
+ SWAP (page 259) 


B.4 December 23, 2005 (NetWare 6.5 SP5) 


Changes were made to the following sections: 


Location Change 


Entire guide. Page design reformatted to comply with revised 
Novell documentation standards. 


Multiple utilities Information was added to the following utilities: 


+ FILER (page 58) 
+ NCOPY (page 115) 
+ NDIR (page 116) 
+ RIGHTS (page 172) 
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Location Change 


Multiple utilities The information about Linux utilities have been 
removed from this book. This includes Attrib 
(Linux), metamig, iprintcmd, ¡Print Driver Store, 
ravsui, and ravview. For information on these 
utitlies, see their associated MAN page or 
corresponding documentation. 


B.5 August 19, 2005 (NetWare 6.5 SP4) 


Changes were made to the following sections: 


Location Change 


Multiple utilities The information about several utilities in this book 
has been updated including Section 1.129, 
“REBUILD,” on page 158, and Section 1.175, 
“VERIFY,” on page 274. 
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